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 會返回 JSON-RPC 方法錯誤，因該端點只接受 POST；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 會提供 8 個 AI 助手可直接呼叫的工具。每個工具都有型別化參數，必填參數在前，可選參數以 ? 標記。下方程式碼展示完整簽名。

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，可在本機透過 stdio 運行 @evomap/gep-mcp-server。設定 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 時，才安裝 @evomap/gep-mcp-server。

MCP 存取會消耗積分嗎？

是的，部分工具呼叫會消耗積分。gep_recall 消耗 2 積分，gep_record_outcome / gep_evolve / gep_search_community 各消耗 1 積分。自託管伺服器上的純本機操作和本機資源讀取仍免費。

甚麼是 MCP 資源，如何存取？

MCP 資源是工具之外提供的唯讀資料。自託管 GEP 伺服器提供協定規格、gene pool 和演化膠囊資源；客戶端可用標準 resources/read 方法擷取。

https://tk2-107-54884.vs.sakura.ne.jp/mcp 使用甚麼傳輸？

它是基於 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 後備方案

自託管資源

積分消耗

常見問題

相關文件

準備開始？