Cheqd MCP Toolkit

Cheqd MCP 工具包

ℹ️ 概览

@cheqd/mcp-toolkit 是一个围绕模型上下文协议（MCP）构建的模块化框架，可让 AI Agent 与 Cheqd 网络交互。MCP 通过提供处理身份相关工作流的结构化方式，规范了 AI Agent 的交互。该工具包使 AI Agent 能够安全地管理去中心化身份（DID）、可验证凭证和信任注册表，是 AI 驱动身份系统的重要组成部分。此代码库允许开发者配置和部署带有可用工具包的 MCP 服务。

🌐 远程 MCP 服务

若要快速开始，您可以连接到我们托管的 MCP 服务。只需将以下配置添加到 Claude Desktop 或 Cursor 的设置文件中：

• Claude Desktop：~/Library/Application Support/Claude/claude_desktop_config.json（macOS）或 %APPDATA%\Claude\claude_desktop_config.json（Windows）

• Cursor：.cursor/mcp.json

{
    "mcpServers": {
        "cheqd-mcp": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://remote-mcp.cheqd.io/mcp"
            ],
        }
    }
}

远程选项无需本地设置，即可立即使用 cheqd 身份工具。

先决条件

• Node.js 20 或更高版本
• pnpm 8 或更高版本
• 具备 TypeScript 和 MCP 的基础知识

📦 软件包

@cheqd/mcp-toolkit

@cheqd/mcp-toolkit 软件包允许您在环境中配置和托管 MCP（模型上下文协议）服务。它集成了此代码库中的工具，为管理身份相关操作提供可定制的基础设施。

功能：

• 可配置的 MCP 服务设置
• 与此代码库中的各种工具集成

使用选项

1. 远程服务（最简单）

连接到我们托管的 MCP 服务——无需本地设置：

{
    "mcpServers": {
        "cheqd-mcp": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://remote-mcp.cheqd.io/mcp"
            ],
        }
    }
}

2. 通过 NPX 运行本地服务

使用此方式在本地运行 Cheqd MCP Server，并传入您自己的环境变量。

{
    "mcpServers": {
        "cheqd": {
            "command": "npx",
            "args": [
                "-y",
                "@cheqd/mcp-toolkit-server"
            ],
            "env": {
                "TOOLS": "credo,<other available tools>",
                ...
            }
        }
    }
}

3. 通过 docker-compose 运行本地服务

使用 env.example 文件并更新相应变量。

{
  "mcpServers": {
    "cheqd-docker-compose": {
      "command": "docker",
      "args": [
        "compose",
        "-f",
        "/path/to/repo/mcp-toolkit/docker/docker-compose.yml",
        "run",
        "--rm",
        "-p", 
        "3000:3000",
        "--name",
        "faber",
        "-T",
        "mcp-server"
      ]
    }
  }
}

@cheqd/mcp-toolkit-credo

@cheqd/mcp-toolkit-credo 软件包是与 @openwalletfoundation/credo-ts 集成的工具包之一，可让 AI Agent 管理 DID 和可验证凭证。它提供以下工具：

• 签发和撤销凭证
• 管理架构和凭证定义
• 基于 DID 的身份验证
• 用于信任注册表验证的 TRAIN

🌍 环境变量

TOOLS="credo"       # Comma separated list of Tools, as of now only 'credo'
CREDO_PORT="3000"   # Port on which the Credo agent will run
CREDO_NAME="faber"  # Name of the Credo Agent
CREDO_ENDPOINT="http://faber:3000"    # Endpoint which Credo Agent is accessible externally
CREDO_CHEQD_TESTNET_MNEMONIC="your-mnemonic-phrase"   # Your Testnet mnemonic phrase
TRAIN_ENDPOINT="https://dev-train.trust-scheme.de/tcr/v1/"    # The TRAIN endpoint for verification of trust registry 
PORT="5000"   # The Port where the Remote MCP Server will run

开发者选项

开发环境设置

1. 安装 pnpm

如果尚未安装 pnpm：

npm install -g pnpm

2. 克隆仓库

git clone https://github.com/cheqd/mcp-toolkit.git
cd mcp-toolkit

3. 安装依赖项

pnpm install

4. 构建软件包

pnpm build

📚 文档

如需了解 Cheqd MCP Toolkit 的详细信息、使用示例和 AI Agent 集成，请参阅我们的官方文档：

👉 cheqd.io 上的 MCP 文档

文档涵盖以下高级主题：

• MCP 的架构和设计
• 将 MCP 与 AI Agent 集成
• 实际用例和模式
• 安全性和信任模型
• 部署建议

💬 社区

我们的 Discord 服务器 是开源社区、软件开发者和节点运营者的主要聊天渠道。

欢迎前往 Discord 与我们讨论项目、寻求帮助并提供反馈。

🙋 通过其他渠道找到我们