Prototyp · Vorschau: alle Server aus der offiziellen Registry, alle 30 Minuten synchronisiert. Mit Google anmelden, um Bewertungen zu schreiben.Prototyp · alle 30 Min. aktualisiert
PopNx MCPMCP-Server für alle, die KI nutzen · in einfachen Worten erklärt

Solucortex MCP

von soluai-spaVersion 1.1.2i★ 0iComputer oder Cloud
Name in der Registryio.github.soluai-spa/solucortex-mcp

So installierst du es

What it does

Living technical memory for AI agents: recall approved project context, record what was learned.

  • Connects Computer oder Cloud
  • Account or key Cloud: Needs Authorization · Local: Needs SOLUCORTEX_API_KEY
  • Category Suche & KI-Gedächtnis

Installation

Wähle die KI-App, die du nutzt, und kopiere die Einstellungen.

5/5 Prüfungen bestanden · Was du fragst, läuft über den Server des Anbieters (mcp.solucortex.ai) · ✓ Befehle geprüft am 14. Nov. 2026

Zuerst: Welche KI nutzt du?

Wähle deine App, dann erscheinen die Schritte unten.

Klappt mit Claude · etwa 5 Min.

Du brauchst einen Schlüssel von Solucortex MCP (auf der Seite des Anbieters erstellen) · Einmal auf claude.ai oder in der Desktop-App einrichten, dann im Chat nutzen · kostenlose Konten können 1 hinzufügen · bei Team/Enterprise fügt ein Owner ihn hinzu

  1. Bei Solucortex MCP registrieren und Schlüssel erstellen

    Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Preise und Gratis-Tarife siehst du auf seiner Seite.

    Wie du einen Schlüssel bekommst, steht unten im README des Anbieters

  2. Öffne die Connectors-Seite von Claude

    CustomizeConnectors

    CustomizeConnectors1Add2https://…3Add4
  3. Klicke „Add“ → „Custom“ → „Web“ und fülle diese 2 Felder aus

    Kopiere jeden Wert in das gleichnamige Feld in Claude und klicke Continue

    Name · NameSolucortex MCP
    Remote MCP server URL · Adressehttps://mcp.solucortex.ai/mcp

    Unter Request headers diesen Namen und Wert hinzufügen

    Header-NameAuthorization
    WertBearer <Schlüssel hier einfügen>

    Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem

    Klicke auf der von Claude erkannten Anmelde-Seite auf Continue · wähle bei Authentication, was der Anbieter angibt (Sign in now, Sign in when needed oder No sign in), dann Add

  4. Im Chat einschalten

    +ConnectorsSolucortex MCP

  5. Ausprobieren

    Nutze Solucortex MCP und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Claude sagt, dass es Solucortex MCP nutzt, oder ein Werkzeug von Solucortex MCP in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

ChatGPT kann Solucortex MCP noch nicht verbinden

Solucortex MCP braucht zum Verbinden deinen eigenen Schlüssel, aber die OpenAI-Hilfe beschreibt nur die Anmeldung per OAuth; eine Schlüssel-Option konnten wir nicht bestätigen

Das kannst du stattdessen tun

A · Eine App nutzen, die Solucortex MCP verbinden kann

  • Du brauchst einen Schlüssel von Solucortex MCP (auf der Seite des Anbieters erstellen) · Einmal auf claude.ai oder in der Desktop-App einrichten, dann im Chat nutzen · kostenlose Konten können 1 hinzufügen · bei Team/Enterprise fügt ein Owner ihn hinzu
  • Du brauchst einen Schlüssel von Solucortex MCP (auf der Seite des Anbieters erstellen)
  • Du brauchst einen Schlüssel von Solucortex MCP (auf der Seite des Anbieters erstellen)
  • Du brauchst einen Schlüssel von Solucortex MCP (auf der Seite des Anbieters erstellen)

B · Andere in Suche & KI-Gedächtnis, die mit ChatGPT funktionieren

Aus den meistgenutzten derselben Kategorie, nur solche, die per Adresse ohne Schlüssel verbinden

Klappt mit Claude Code · etwa 5 Min.

Du brauchst einen Schlüssel von Solucortex MCP (auf der Seite des Anbieters erstellen)

  1. Bei Solucortex MCP registrieren und Schlüssel erstellen

    Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Preise und Gratis-Tarife siehst du auf seiner Seite.

    Wie du einen Schlüssel bekommst, steht unten im README des Anbieters

  2. Terminal öffnen

    Mac: Command+Leertaste drücken und Terminal tippen · Windows: PowerShell öffnen

  3. Diesen Befehl einfügen und Enter drücken

    claude mcp add --transport http --scope user solucortex https://mcp.solucortex.ai/mcp --header 'Authorization: Bearer your-value'

    Ersetze „your-value“ vor dem Enter durch deinen Schlüssel

    Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem

  4. /mcp in Claude Code eingeben

    Solucortex MCP sollte in der Liste als verbunden erscheinen

  5. Ausprobieren

    Nutze Solucortex MCP und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Claude Code sagt, dass es Solucortex MCP nutzt, oder ein Werkzeug von Solucortex MCP in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit Cursor · etwa 5 Min.

Du brauchst einen Schlüssel von Solucortex MCP (auf der Seite des Anbieters erstellen)

  1. Bei Solucortex MCP registrieren und Schlüssel erstellen

    Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Preise und Gratis-Tarife siehst du auf seiner Seite.

    Wie du einen Schlüssel bekommst, steht unten im README des Anbieters

  2. Mit diesem Button Cursor öffnen

    In Cursor öffnen

    Cursor fragt nach einer Bestätigung; klicke Install

  3. Schlüssel eintragen

    In den Einstellungen von Solucortex MCP ist Authorization leer; trag deinen Schlüssel ein und speichere

    Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem

  4. KI-Chat in Cursor im Agent-Modus öffnen

  5. Ausprobieren

    Nutze Solucortex MCP und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Cursor sagt, dass es Solucortex MCP nutzt, oder ein Werkzeug von Solucortex MCP in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Cursor abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit VS Code · etwa 5 Min.

Du brauchst einen Schlüssel von Solucortex MCP (auf der Seite des Anbieters erstellen)

  1. Bei Solucortex MCP registrieren und Schlüssel erstellen

    Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Preise und Gratis-Tarife siehst du auf seiner Seite.

    Wie du einen Schlüssel bekommst, steht unten im README des Anbieters

  2. Mit diesem Button VS Code öffnen

    In VS Code öffnen

    VS Code fragt nach einer Bestätigung; klicke Install

  3. Schlüssel eintragen

    In den Einstellungen von Solucortex MCP ist Authorization leer; trag deinen Schlüssel ein und speichere

    Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem

  4. KI-Chat in VS Code im Agent-Modus öffnen

  5. Ausprobieren

    Nutze Solucortex MCP und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn VS Code sagt, dass es Solucortex MCP nutzt, oder ein Werkzeug von Solucortex MCP in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von VS Code abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Andere Apps mit MCP, etwa Windsurf, Zed oder Gemini CLI, fügen Server unterschiedlich hinzu. Sieh in der App-Liste nach

Alle Apps mit MCP ansehen →

Adresse für Apps, die über das Web verbinden

Adressehttps://mcp.solucortex.ai/mcp

JSON-Einstellungen stehen unten unter „Für Entwickler“

Hängst du fest? Frag Leute, die Solucortex MCP nutzen💬 Diskussion →
Für Entwickler: Terminal-Befehle und JSON-Einstellungen

Über das Web

Claude Code

claude mcp add --transport http --scope user solucortex https://mcp.solucortex.ai/mcp --header 'Authorization: Bearer your-value'

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "solucortex": {
      "url": "https://mcp.solucortex.ai/mcp",
      "headers": {
        "Authorization": "Bearer your-value"
      }
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "solucortex": {
      "type": "http",
      "url": "https://mcp.solucortex.ai/mcp",
      "headers": {
        "Authorization": "Bearer your-value"
      }
    }
  }
}

Auf deinem Computer installiert

Claude Code

claude mcp add --scope user solucortex --env SOLUCORTEX_API_KEY=your-value -- uvx solucortex-mcp

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "solucortex": {
      "command": "uvx",
      "args": [
        "solucortex-mcp"
      ],
      "env": {
        "SOLUCORTEX_API_KEY": "your-value"
      }
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "solucortex": {
      "command": "uvx",
      "args": [
        "solucortex-mcp"
      ],
      "env": {
        "SOLUCORTEX_API_KEY": "your-value"
      }
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "solucortex": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "solucortex-mcp"
      ],
      "env": {
        "SOLUCORTEX_API_KEY": "your-value"
      }
    }
  }
}

Werte, die du selbst einträgst

  • SOLUCORTEX_API_KEY geheim erforderlich env
    SoluCortex project API key (scx_...). Get one at https://solucortex.ai.
  • SOLUCORTEX_PROJECT_ID env
    Default project UUID. Optional: the backend infers it from the API key.
  • Authorization geheim erforderlich HTTP header
    Bearer . Get one at https://solucortex.ai.
  • X-Solucortex-Project HTTP header
    Default project UUID. Optional: the backend infers it from the API key.

Die Beschreibungen sind noch im englischen Original.

Diese Einstellungen werden aus dem Registry-Eintrag des Entwicklers erzeugt. Wenn in der README etwas anderes steht, folge der README.

Auf einen Blick

Downloads pro Wochei
16/Wo.
Verbindung
Computer oder Cloud
Transport
stdio, streamable-http
Neueste Versioni
1.1.2
In der Registry veröffentlichti
8. Sept. 2026
Code zuletzt geänderti
6. Okt. 2026
Entwickler
soluai-spa
Pakete
pypi: solucortex-mcp
Registry-Status
Aktiv

Welche Apps ihn nutzen können

Basierend darauf, wie sich dieser Server verbindet, und auf der eigenen Doku jeder App, geprüft am 10. Nov. 2026.

Verbinden sich über das Internet in

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast

Laufen auf deinem Computer in

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

Alle Apps, mit Vor- und Nachteilen →

Was er kann

Tool-Namen und -Beschreibungen genau so, wie der Server sie am 14. Nov. 2026 gemeldet hat. Geschrieben hat sie der Entwickler, nicht wir; wir zeigen sie als reinen Text.

  • solucortex_recall

    Build living context for a task (POST /context/build). Call this at the START of a task, before touching code: returns approved, active memories (decisions, conventions, risks, sensitive modules, architecture) ranked by semantic similarity + importance. Uses OpenAI embeddings (sl

  • solucortex_search

    Ad-hoc semantic search of memories (POST /search/semantic). Use for specific questions during a task (e.g. 'how is authentication implemented?'), distinct from recall which builds the full startup context. Uses OpenAI embeddings (20 req/min).

  • solucortex_remember

    Record a memory in SoluCortex (POST /memories). Call when closing a task or making a relevant technical decision. As an authorized agent (Bearer api_key), the memory is stored with status 'approved' and traced. Never store real secrets: if you find one, record location/type/sever

  • solucortex_update_memory

    Correct an existing memory (PATCH /memories/{id}). Agents propose, humans govern: the edit is applied but the memory returns to PENDING until a human re-approves it. ALWAYS tell the user the change awaits their approval in the SoluCortex panel. Status changes are not possible her

  • solucortex_flag_memory

    Flag a memory as outdated/incorrect (POST /memories/{id}/flag). The memory is marked for human review in the SoluCortex panel; nothing is deleted or unpublished. ALWAYS tell the user a memory awaits their decision in the panel. Deletion is human-only by design.

  • solucortex_list_memories

    List the project's memories without semantic search (GET /memories). Useful for quick inspection/audit or to confirm a just-created memory was stored. Does not consume OpenAI quota.

Basischecksi

Wir prüfen Informationen, die jeder sehen kann; den Code haben wir nicht gelesen. Checks, die nicht zutreffen, werden nicht mitgezählt. · Geprüft am 16. Nov. 2026

  • ✓ Bestanden

    Entwickler passt zum Repo

    Der Registry-Name wurde mit dem GitHub-Konto soluai-spa bestätigt, dem das Repo gehört

  • ✓ Bestanden

    Wird noch gepflegt

    Code zuletzt geändert: vor 41 Tagen

  • ✓ Bestanden

    Hat eine Lizenz

    Nutzt MIT

  • ✓ Bestanden

    Endpunkt antwortet

    Antwort in 518 ms (HTTP 200)

  • – Nicht zutreffend

    Anmeldung mit OAuth

    Keine Anmeldung nötig

  • ✓ Bestanden

    Keine versteckten Anweisungen in Tool-Beschreibungen

    Wir haben 6 Tool-Beschreibungen gelesen und keine versteckten Anweisungen an die KI gefunden

Veröffentlichte Schwachstellen (OSV.dev)

Keine Einträge auf OSV.dev für solucortex-mcp@1.1.2

Prüft nur diese Paketversion, nicht alle Abhängigkeiten · geprüft 15. Nov. 2026

Was wir prüfen → · JSON

Entwickler: neue Prüfung anfordern oder falsche Angaben melden

Diskussion

Fragen, Tipps teilen oder melden, dass etwas nicht geht. Sortiert nach „hilfreich“.

Noch keine Beiträge. Stell die erste Frage oder teile einen Tipp.

Beiträge hier stammen von Nutzern, nicht vom PopNx-Team.

Anmelden, um zu posten

Nutzerbewertungen

Noch keine Bewertungen

Anmelden, um eine Bewertung zu schreiben

Im Vergleich mit anderen in Suche & KI-Gedächtnisi

  • Mehr Sterne als 0 % der anderen 6195 Server in dieser Kategorie
  • Neuer in der Registry veröffentlicht als 35 % der anderen 6195 Server in dieser Kategorie
  • Basischecks gleich gut wie oder besser als bei 100 % der anderen 6195 Server in dieser Kategorie

Verglichen mit allen aktiven Servern dieser Kategorie in der Registry. Sterne zählen nur, wenn dem Herausgeber das Repo gehört.

Häufige Fragen

Ist Solucortex MCP sicher?

Er hat 5 von 5 zutreffenden Basischecks bestanden. Den Code haben wir nicht gelesen. Bevor du einen Schlüssel oder Token hinzufügst, sieh nach, welche Zugriffe der Server verlangt, und nutze einen Schlüssel, der nur die Berechtigungen hat, die du brauchst.

Welche Schlüssel oder Codes braucht er?

Das musst du eintragen: Authorization, SOLUCORTEX_API_KEY

Läuft er auf meinem Computer oder in der Cloud?

Beides geht: Installiere ihn auf deinem Computer oder verbinde dich mit der Cloud-Version.

Wird er noch gepflegt?

Das GitHub-Repo wurde zuletzt vor 41 Tagen geändert, und die neueste Version (1.1.2) kam vor 2 Monaten in die Registry.

Welche Apps können ihn nutzen?

Apps, die MCP unterstützen, etwa Claude Desktop, Claude Code, Cursor und VS Code. Er verbindet sich per URL und funktioniert daher auch in Apps mit Remote-MCP, etwa ChatGPT im Web (volles MCP ab Business; Pro nur lesend).

Was kann ich stattdessen nutzen?

In derselben Kategorie: OpenSEO, Exa, Mockserver, Microsoft Learn MCP, Docs

Ähnliche Alternativen

Gleiche Kategorie, andere Entwickler, Befehle bereits geprüft. Offizielle zuerst, dann nach Sternen.

So liest du eine Karte:↓ Downloads pro Wochei★ GitHub-SterneiDrei Säulen: Bewertungen · Checks · NutzungiAktualisiert = neueste Version in der Registry veröffentlichti

OpenSEO

Keyword research, site audits, rank tracking and AI visibility for your AI agent.

von every-appWeit verbreitet★ 27.774Aktualisiert vorgestern

Läuft in der Cloud✓ everyapp.com

Exa

Connect AI agents to Exa for web search, content fetching, and multi-step research.

von exa-labsWeit verbreitet★ 5234Aktualisiert vor 2 Monaten

Läuft in der Cloud✓ vom Dienst · exa.aiVom PopNx-Team ausprobiert

Mockserver

Mock, record/replay, verify and chaos-test any HTTP, REST, gRPC or LLM dependency over MCP.

von mock-serverWachsend★ 5011Aktualisiert vor 20 Tagen

Läuft auf deinem Computer✓ vom Dienst · mock-server.com

Microsoft Learn MCP

Official Microsoft Learn MCP Server – real-time, trusted docs & code samples for AI and LLMs.

von MicrosoftDocsWeit verbreitet★ 1992Aktualisiert vor 12 Monaten

Läuft in der Cloud✓ vom Dienst · microsoft.comVom PopNx-Team ausprobiert

Docs

Search and read Empryo's documentation. Read-only, no auth, no local access.

von proxysoulWachsend★ 1614Aktualisiert vor 2 Monaten

Läuft in der Cloud✓ empryo.com
  • OpenSEO — Läuft in der Cloud, keine Installation · Kein Schlüssel nötig
  • Exa — Läuft in der Cloud, keine Installation · Kein Schlüssel nötig · Im Verzeichnis von Claude
  • Mockserver — Wird auf deinem Rechner installiert · Kein Schlüssel nötig
  • Microsoft Learn MCP — Läuft in der Cloud, keine Installation · Kein Schlüssel nötig · Im Verzeichnis von Claude
  • Docs — Läuft in der Cloud, keine Installation · Kein Schlüssel nötig

README vom Entwickler

README öffnen

Unverändert aus dem Repo des Entwicklers übernommen. PopNx MCP hat den Inhalt weder geprüft noch empfiehlt es ihn. HTML, Bilder und Skripte wurden entfernt. Links führen von dieser Website weg.

SoluCortex MCP

Official Model Context Protocol server for [SoluCortex](https://solucortex.ai) — living technical memory for AI agents.

Connect any MCP-compatible agent (Claude Code, Claude Desktop, Cursor, Codex, Cline, …) to your SoluCortex project so it can recall the decisions, conventions, risks and architecture that matter before it works, and remember what it learns when it's done.

Website: solucortex.ai · Setup guide: solucortex.ai/docs/mcp · Tools reference: solucortex.ai/docs/mcp-tools · PyPI: solucortex-mcp · MCP Registry: io.github.soluai-spa/solucortex-mcp

Tools

ToolWhat it doesWhen to use
solucortex_recallBuilds living context for a task (ranked by semantic similarity + importance)At the start of a task, before touching code
solucortex_searchAd-hoc semantic search over the project's memoriesSpecific questions mid-task
solucortex_rememberRecords a memory (stored approved + traced as an authorized agent)At close, or on a relevant technical decision
solucortex_update_memoryCorrects an existing memory — the edit returns it to pending for human re-approval in the panelWhen a memory is right in spirit but wrong in detail
solucortex_flag_memoryFlags a memory as outdated/incorrect with a reason; a human resolves it in the panelWhen a memory should be reviewed, archived or deleted
solucortex_list_memoriesLists memories without semantic searchQuick inspection / audit

Governance by design: agents propose, humans govern. Agents can never change a

memory's status, rewrite its metadata, or delete it — edits go back to pending and

deletions only happen from the SoluCortex panel.

Requirements

  • A SoluCortex account and a project API key (prefix scx_) — get it from your SoluCortex dashboard.
  • One of: uv (recommended), Python ≥ 3.10, or Docker.

Configuration

stdio mode (default, local)

The server is configured entirely through environment variables:

VariableRequiredDescription
SOLUCORTEX_API_KEY✅Project API key (scx_…)
SOLUCORTEX_PROJECT_IDoptionalDefault project UUID; if omitted, the backend infers it from the API key
SOLUCORTEX_URLoptionalAPI base URL. Default https://solucortex.ai
HTTP mode (remote, multi-tenant)

Run with MCP_TRANSPORT=http (or --http) to serve Streamable HTTP on $PORT (default 8080) — the mode behind https://mcp.solucortex.ai. Credentials travel with each request and the environment is ignored:

HeaderRequiredDescription
Authorization: Bearer scx_…✅The caller's project API key (401 without it)
X-Solucortex-ProjectoptionalDefault project UUID; if omitted, the backend infers it from the API key

GET /health (and /healthz locally; Cloud Run's frontend intercepts /healthz) responds without auth. The MCP endpoint is /mcp, runs stateless, and shares nothing between requests/tenants.

Never commit your API key. Keep it in your MCP client config's env block or a local .env (see .env.example).

Install

Remote (recommended — nothing to install)

The hosted server at https://mcp.solucortex.ai/mcp speaks Streamable HTTP; your key travels with each request:

claude mcp add --transport http solucortex https://mcp.solucortex.ai/mcp \

--header "Authorization: Bearer scx_xxx" \ --header "X-Solucortex-Project: your-project-uuid"

Or in any client with remote MCP support:

{

"mcpServers": { "solucortex": { "type": "http", "url": "https://mcp.solucortex.ai/mcp", "headers": { "Authorization": "Bearer scx_xxx", "X-Solucortex-Project": "your-project-uuid" } } } }

Claude Code (local, stdio)
claude mcp add solucortex \

-e SOLUCORTEX_API_KEY=scx_xxx \ -e SOLUCORTEX_PROJECT_ID=your-project-uuid \ -- uvx solucortex-mcp

Claude Desktop / Cursor / Cline (JSON config)

Add to the client's MCP config (claude_desktop_config.json, Cursor mcp.json, etc.):

{

"mcpServers": { "solucortex": { "command": "uvx", "args": ["solucortex-mcp"], "env": { "SOLUCORTEX_API_KEY": "scx_xxx", "SOLUCORTEX_PROJECT_ID": "your-project-uuid" } } } }

From a local clone
git clone https://github.com/soluai-spa/solucortex-mcp

cd solucortex-mcp cp .env.example .env # fill in your key ./run.sh # loads .env, then runs via uv

or, with SOLUCORTEX_* already exported: uv run solucortex-mcp

Docker

Prebuilt image on GHCR:

docker run --rm -i \

-e SOLUCORTEX_API_KEY=scx_xxx \ ghcr.io/soluai-spa/solucortex-mcp:latest

Or build it yourself:

docker build -t solucortex-mcp .

docker run --rm -i \ -e SOLUCORTEX_API_KEY=scx_xxx \ -e SOLUCORTEX_PROJECT_ID=your-project-uuid \ solucortex-mcp

The server speaks MCP over stdio, so clients launch it as a subprocess (-i keeps stdin open).

Instructions for your agent (AGENTS.md)

Once connected, give your agent the methodology too: copy templates/AGENTS.md into the root of your repo (it works as AGENTS.md or CLAUDE.md). The MCP handshake already carries these instructions — the file lets you version them alongside your code, extend them with your own conventions, and optionally enable the commented Claude Code hook recipe for guaranteed recall.

Development

uv sync

uv run solucortex-mcp # run (stdio) MCP_TRANSPORT=http uv run solucortex-mcp # run (HTTP on :8080) uv run pytest # test suite npx @modelcontextprotocol/inspector uv run solucortex-mcp # interactive test

Notes

  • Memory type vocabulary: the canonical set is architecture, decision, risk, convention, bug_history, tech_debt, sensitive_module, learning, external_integration. Some backends accept an older set (technical_decision, historical_bug, current_state, task_closure). The server passes type through and surfaces HTTP 422 so you can retry with the other set.
  • Never store real secrets in a memory. Record location, type, severity and action taken instead.

License

MIT — see LICENSE.