Skip to main content
Glama
deenesjakoruzh
soluai-spa

solucortex-mcp

Official
by soluai-spa
OverviewSchemaRelated ServersScoreDiscussions
Python
Hybrid

SoluCortex MCP

Model Context Protocol の公式サーバー、 SoluCortex 向け — AIエージェントのための生きた技術的メモリです。

MCP互換のエージェント（Claude Code、Claude Desktop、Cursor、Codex、Cline、…）をSoluCortexプロジェクトに接続すると、作業を始める前に重要となる決定、規約、リスク、アーキテクチャを想起し、完了時に学んだことを記憶できます。

ツール

ツール

機能

使用タイミング

solucortex_recall

タスクのための生きたコンテキストを構築（意味的類似性＋重要度でランク付け）

タスクの開始時、コードに触れる前

solucortex_search

プロジェクトのメモリに対するアドホックな意味的検索

タスク中の具体的な質問

solucortex_remember

メモリを記録（approvedとして保存＋認証済みエージェントとして追跡）

完了時、または関連する技術的決定時

solucortex_list_memories

意味的検索なしでメモリを一覧表示

簡単な確認 / 監査

Related MCP server: Muninn

要件

  • SoluCortexアカウントとプロジェクトAPIキー（接頭辞 scx_）— SoluCortexダッシュボードから取得できます。

  • いずれか1つ: 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](. 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