https://github.com/agent-network-protocol/mcp2anp
A MCP server that can convert the MCP protocol into the ANP protocol, enabling applications that support MCP to also support ANP.
https://github.com/agent-network-protocol/mcp2anp
Last synced: 3 months ago
JSON representation
A MCP server that can convert the MCP protocol into the ANP protocol, enabling applications that support MCP to also support ANP.
- Host: GitHub
- URL: https://github.com/agent-network-protocol/mcp2anp
- Owner: agent-network-protocol
- License: mit
- Created: 2025-09-28T08:38:15.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2025-11-28T08:24:37.000Z (4 months ago)
- Last Synced: 2025-11-30T15:45:55.101Z (4 months ago)
- Language: Python
- Homepage:
- Size: 392 KB
- Stars: 7
- Watchers: 0
- Forks: 4
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Agents: AGENTS.md
Awesome Lists containing this project
README
# MCP2ANP
> MCP ↔ ANP 桥接服务，让支持 MCP 的客户端像调用本地工具一样使用 ANP 智能体。
## 快速开始
### 第一步：获取 API Key
在使用 MCP2ANP 之前，你需要先获取一个 API Key：
1. 访问 [DID-HOST](https://didhost.cc) 并登录账户
2. 新建 DID Card，在创建流程中勾选"生成 API Key"
3. 将生成的私钥与 API Key 安全保存（它们仅显示一次，丢失后无法恢复）
**验证 API Key（可选）**：
```bash
curl -sS -H "X-API-Key: YOUR_API_KEY" \
"https://didhost.cc/api/v1/mcp-sk-api-keys/verify" | jq .
```
### 第二步：使用官方托管（推荐）
在 Claude 中直接使用官方托管端点，无需安装和配置：
```bash
claude mcp add --transport http mcp2anp-remote https://agent-connect.ai/mcp2anp/mcp \
--header "X-API-Key: YOUR_API_KEY"
```
将 `YOUR_API_KEY` 替换为你在第一步中获取的 API Key。
### 第三步：本地启动服务器（可选）
如果你需要自托管服务器，可以按照以下步骤操作：
#### 3.1 安装依赖
```bash
git clone git@github.com:agent-network-protocol/mcp2anp.git
cd mcp2anp
uv venv --python 3.11
uv sync
```
#### 3.2 配置 DID 凭证
**方式 1: 使用默认凭证（开发测试）**
直接启动，使用项目提供的默认公共 DID 凭证：
```bash
uv run python -m mcp2anp.server
```
**方式 2: 通过环境变量配置（推荐生产环境）**
```bash
# 设置 DID 文件路径
export ANP_DID_DOCUMENT_PATH="docs/did_public/public-did-doc.json"
export ANP_DID_PRIVATE_KEY_PATH="docs/did_public/public-private-key.pem"
# 启动服务
uv run python -m mcp2anp.server --log-level INFO
```
**方式 3: 在 Claude 中添加本地服务器**
```bash
# 将仓库根目录赋值给变量（替换为你的实际路径）
MCP2ANP_DIR=/Users/yourname/mcp2anp
claude mcp add mcp2anp \
--env ANP_DID_DOCUMENT_PATH=$MCP2ANP_DIR/docs/did_public/public-did-doc.json \
--env ANP_DID_PRIVATE_KEY_PATH=$MCP2ANP_DIR/docs/did_public/public-private-key.pem \
-- uv run --directory $MCP2ANP_DIR python -m mcp2anp.server
```
### 第四步：运行官方 Demo
运行官方演示脚本，查看完整的使用示例：
```bash
uv run python examples/mcp_client_demo.py
```
Demo 会演示：
- 列出可用工具
- 调用 `anp.fetchDoc` 获取智能体描述文档
- 调用 `anp.invokeOpenRPC` 执行 OpenRPC 方法