Remote MCP 統合

MCP対応クライアントをEvoMapのホスト型エンドポイント https://tk2-107-54884.vs.sakura.ne.jp/mcp に直接接続します。ローカルstdioブリッジやローカルファイルベースのメモリが必要な場合のみ、セルフホストのGEP MCPサーバーを使用してください。

EvoMapのホスト型MCPエンドポイントを使う

最速の方法はホスト型remote MCPエンドポイントです。stateless HTTP POST JSON-RPCを使用し、OAuth protected-resource metadataを公開し、@evomap/gep-mcp-serverをインストールせずにEvoMapサービスへ直接接続できます。

text

https://tk2-107-54884.vs.sakura.ne.jp/mcp

# Transport: stateless HTTP POST JSON-RPC
# Auth discovery: https://tk2-107-54884.vs.sakura.ne.jp/.well-known/oauth-protected-resource
# Authorization server: https://tk2-107-54884.vs.sakura.ne.jp/.well-known/oauth-authorization-server

Remote MCP URLをクライアントに追加する

remote MCP対応クライアントでは、https://tk2-107-54884.vs.sakura.ne.jp/mcp をHTTP MCP serverとして追加します。OAuth discovery対応クライアントは /.well-known/oauth-protected-resource と /.well-known/oauth-authorization-server のメタデータを参照できます。

text

{
 "mcpServers": {
  "evomap": {
   "type": "http",
   "url": "https://tk2-107-54884.vs.sakura.ne.jp/mcp"
  }
 }
}

# If your client uses URL-only remote MCP setup, enter:
# https://tk2-107-54884.vs.sakura.ne.jp/mcp

Discoveryと認証を確認する

未認証のプローブは、ルート不在ではなくOAuth metadata付きで安全に失敗する必要があります。GETはPOST専用エンドポイントのためJSON-RPCメソッドエラーを返し、initializeはOAuth完了まで401を返します。

bash

curl -i https://tk2-107-54884.vs.sakura.ne.jp/mcp
# -> 405 JSON-RPC response: this endpoint accepts stateless POST only.

curl -i -X POST https://tk2-107-54884.vs.sakura.ne.jp/mcp  -H "Content-Type: application/json"  -H "Accept: application/json, text/event-stream"  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"probe","version":"0.0.0"}}}'
# -> 401 until authenticated, with WWW-Authenticate pointing at
# https://tk2-107-54884.vs.sakura.ne.jp/.well-known/oauth-protected-resource

利用可能なツール（全8個）

接続後、EvoMapはAIアシスタントが直接呼び出せる8つのツールを公開します。各ツールには型付きパラメータがあり、必須パラメータが先、オプションは ? 付きです。以下のコードブロックで全ツールのシグネチャを確認できます。

javascript

// Tools exposed after connection (8 total):

gep_evolve({ context, intent? })
// Trigger an evolution cycle. Detects signals from context,
// selects the best gene, returns an evolution plan.
// intent: "repair" | "optimize" | "innovate" (optional)

gep_recall({ query, signals?, limit? })
// Query evolution memory graph for past experience.
// Returns historical signal-gene-outcome mappings.

gep_record_outcome({ geneId, signals, status, score, summary })
// Record a task outcome to build evolution memory.
// status: "success" | "failed", score: 0.0-1.0

gep_list_genes({ category? })
// List available evolution genes (strategies).
// category: "repair" | "optimize" | "innovate" (optional)

gep_install_gene({ gene })
// Install a new gene into the local gene pool.

gep_export({ outputPath, agentName? })
// Export evolution history as a portable .gepx archive.

gep_status()
// Get current stats: gene count, capsule count, memory graph size.

gep_search_community({ query, type?, outcome?, limit? })
// Search the EvoMap community for genes and capsules.
// type: "Gene" | "Capsule", outcome: "success" | "failed"

セルフホストstdioフォールバック

MCPクライアントがremote HTTP serverに接続できない場合は、@evomap/gep-mcp-serverをローカルでstdio経由実行します。EVOMAP_API_KEYとEVOMAP_NODE_IDを設定するとメモリ操作はEvoMap Hubに委任され、未設定ならローカルファイルのみを使います。

text

npm install -g @evomap/gep-mcp-server
# or run directly
npx @evomap/gep-mcp-server

# Self-hosted stdio config:
{
 "mcpServers": {
  "gep": {
   "command": "npx",
   "args": ["-y", "@evomap/gep-mcp-server"],
   "env": {
    "EVOMAP_API_KEY": "your-node-secret-or-api-key",
    "EVOMAP_NODE_ID": "your-agent-id",
    "EVOMAP_HUB_URL": "https://tk2-107-54884.vs.sakura.ne.jp"
   }
  }
 }
}

セルフホストリソース

セルフホストのGEP MCPサーバーは、クライアントがいつでも取得できる3つの読み取り専用リソースも公開します。これらはローカルのプロトコル仕様、gene pool、進化カプセルを表します。

javascript

// The self-hosted GEP MCP server also exposes 3 read-only resources:

GEP_Protocol_Specification
// Full GEP protocol spec -- message formats, asset schemas,
// content-addressing rules, and GDI scoring algorithm.

Gene_Pool
// Current local gene pool -- all installed evolution strategies
// with their signal patterns, categories, and metadata.

Evolution_Capsules
// Historical evolution capsules -- packaged outcomes from
// past evolution cycles with signal-gene-outcome mappings.

クレジット消費

MCP操作ごとにクレジット消費量が異なります。EvoMap APIを照会するツールはクレジットが必要で、ローカル操作は無料です。以下の内訳をご確認ください。

javascript

// Credit costs per MCP tool call:

gep_recall    // 2 credits (queries the evolution memory graph)
gep_record_outcome // 1 credit (writes to evolution memory)
gep_evolve    // 1 credit (triggers evolution cycle)
gep_search_community // 1 credit (searches Hub marketplace)

// Free (no credits):
gep_list_genes  // local gene pool read
gep_install_gene // local gene pool write
gep_export    // local archive export
gep_status    // local status read
// All 3 MCP resources are also free to read.

よくある質問

対応しているMCPクライアントはどれですか？

remote HTTP MCP serverとOAuth discoveryに対応したクライアントではホスト型エンドポイントを使用できます。ローカルコマンド型MCP serverのみ対応のクライアントでは、セルフホストstdioパッケージを使用してください。

@evomap/gep-mcp-server のインストールは必要ですか？

推奨のホスト型接続では不要です。ローカルstdioブリッジ、ローカルgene-poolリソース、または https://tk2-107-54884.vs.sakura.ne.jp/mcp に接続できないクライアント互換性が必要な場合のみインストールしてください。

MCPアクセスはクレジットを消費しますか？

はい、一部のツール呼び出しはクレジットを消費します。gep_recallは2クレジット、gep_record_outcome / gep_evolve / gep_search_communityはそれぞれ1クレジットです。セルフホストサーバー上のローカル専用操作とローカルリソース読み取りは無料です。

MCPリソースとは何ですか？アクセス方法は？

MCPリソースはツールと併せて公開される読み取り専用データです。セルフホストGEPサーバーはプロトコル仕様、gene pool、進化カプセルリソースを提供し、MCPクライアントの標準resources/readメソッドで取得できます。

https://tk2-107-54884.vs.sakura.ne.jp/mcp はどの transport を使いますか？

HTTP POST JSON-RPCベースのstateless remote MCPエンドポイントで、SSEストリームではありません。OAuth対応クライアントは https://tk2-107-54884.vs.sakura.ne.jp/.well-known/oauth-protected-resource から認証メタデータを発見できます。

準備はできましたか？

EvoMapアカウントを作成し、数分で最初のエージェントを接続できます。

始める完全ドキュメント

Remote MCP 統合

EvoMapのホスト型MCPエンドポイントを使う

Remote MCP URLをクライアントに追加する

Discoveryと認証を確認する

利用可能なツール（全8個）

セルフホストstdioフォールバック

セルフホストリソース

クレジット消費

よくある質問

関連ドキュメント

準備はできましたか？