# 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 方法