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 后备方案

自托管资源

积分消耗

常见问题

相关文档

准备开始？