Skip to main content
Glama
deenesjakoruzh
soluai-spa

solucortex-mcp

Official
by soluai-spa
OverviewSchemaRelated ServersScoreDiscussions
Python
Hybrid

SoluCortex MCP

SoluCortex 的官方 Model Context Protocol 服务器——为 AI 代理提供动态技术记忆。

将任何兼容 MCP 的代理（Claude Code、Cluade Desktop、Cursor、Codex、Cline 等）连接到你的 SoluCortex 项目，使其能在开始工作前回忆重要的决策、约定、风险和架构，并在完成后记住学到的内容。

工具

工具

作用

使用时机

solucortex_recall

为任务构建动态上下文（按语义相似度和重要性排序）

在任务开始时、改动代码之前

solucortex_search

对项目记忆进行临时语义搜索

任务中途遇到具体问题时

solucortex_remember

记录一条记忆（以 approved 状态存储，并作为授权代理进行追踪）

在收尾时，或做出相关技术决策时

solucortex_list_memories

列出记忆，不进行语义搜索

快速检查/审计

Related MCP server: Muninn

要求

  • 一个 SoluCortex 账户和一个项目 API 密钥（前缀 scx_）——从你的 SoluCortex 仪表板 获取。

  • 以下任选其一：uv（推荐）、Python ≥ 3.10 或 Docker。

配置

stdio 模式（默认，本地）

服务器完全通过环境变量进行配置：

变量

是否必需

说明

SOLUCORTEX_API_KEY

✅

项目 API 密钥（scx_…）

SOLUCORTEX_PROJECT_ID

推荐

默认项目 UUID（可在每次调用时覆盖）

SOLUCORTEX_URL

可选

API 基础 URL。默认 https://solucortex.ai

HTTP 模式（远程，多租户）

使用 MCP_TRANSPORT=http（或 --http）运行，即可在 $PORT（默认 8080）上提供 Streamable HTTP 服务——这是 https://mcp.solucortex.ai 背后的模式。凭据随每个请求一起传递，环境变量会被忽略：

请求头

是否必需

说明

Authorization: Bearer scx_…

✅

调用方的项目 API 密钥（缺少时返回 401）

X-Solucortex-Project

推荐

会话的默认项目 UUID

GET /health（本地还有 /healthz；Cloud Run 的前端会拦截 /healthz）无需认证即可响应。MCP 端点为 /mcp，以无状态方式运行，请求/租户之间不共享任何内容。

切勿将 API 密钥提交到仓库。请将其保存在 MCP 客户端配置的 env 块中，或本地 .env 文件中（参见 .env.example）。

安装

远程（推荐——无需安装）

位于 https://mcp.solucortex.ai/mcp 的托管服务器支持 Streamable HTTP；你的密钥随每个请求一起传递：

claude mcp add --transport http solucortex https://mcp.solucortex.ai/mcp \
  --header "Authorization: Bearer scx_xxx" \
  --header "X-Solucortex-Project: your-project-uuid"

或者在任何支持远程 MCP 的客户端中：

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

Claude Code（本地，stdio）

claude mcp add solucortex \
  -e SOLUCORTEX_API_KEY=scx_xxx \
  -e SOLUCORTEX_PROJECT_ID=your-project-uuid \
  -- uvx --from git+https://github.com/soluai-spa/solucortex-mcp solucortex-mcp

（发布到 PyPI 后：将该命令替换为 uvx solucortex-mcp。）

Claude Desktop / Cursor / Cline（JSON 配置）

将其添加到客户端的 MCP 配置中（claude_desktop_config.json、Cursor 的 mcp.json 等）：

{
  "mcpServers": {
    "solucortex": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/soluai-spa/solucortex-mcp", "solucortex-mcp"],
      "env": {
        "SOLUCORTEX_API_KEY": "scx_xxx",
        "SOLUCORTEX_PROJECT_ID": "your-project-uuid"
      }
    }
  }
}

从本地克隆安装

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

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

服务器通过 stdio 提供 MCP 服务，因此客户机会将其作为子进程启动（-i 保持标准输入打开）。

开发

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

注意事项

  • 记忆的 type 词汇表：标准集合为 architecture, decision, risk, convention, bug_history, tech_debt, sensitive_module, learning, external_integration。某些后端接受较旧的集合（technical_decision, historical_bug, current_state, task_closure）。服务器会原样传递 type 并返回 HTTP 422，以便你使用另一组集合重试。

  • 切勿在记忆中存储真实机密。应改为记录位置、类型、严重程度和已采取的操作。

许可证

MIT — 参见 LICENSE。

Install Server
A
license - permissive license
A
quality
B
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

Related MCP Servers

  • ContextAtlas

    codefromkarl
    A
    license
    Not graded
    quality
    C
    maintenance
    Enables AI coding agents to retrieve and manage code context with hybrid search, project memory, and observability via MCP tools.
    29
    MIT

  • mcp-chest-memory

    siosig
    A
    license
    Not graded
    quality
    B
    maintenance
    Provides a persistent, local-first memory for coding agents over MCP, enabling automatic recall and recording of past work, failures, and decisions to reduce repetition and token usage.
    MIT

  • apex-memory

    JJerryChoi
    A
    license
    Not graded
    quality
    C
    maintenance
    Persistent memory for AI coding agents. Enables agents to save and recall decisions, patterns, bugs, and context across sessions via an MCP server with local SQLite storage.
    45
    2
    MIT

View all related MCP servers

Related MCP Connectors

  • XMemo

    Shared, governed long-term memory for AI agents across tools and sessions via MCP and REST.

  • mcp

    Your memory, everywhere AI goes. Build knowledge once, access it via MCP anywhere.

  • Sprintra

    The project brain for AI coding agents — memory, decisions, sprints, knowledge base via MCP.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/soluai-spa/solucortex-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server