Clawdentials MCP 服务器

使用说明(Markdown)

  • 项目简介

    • Clawdentials MCP 服务器是一套基于 Model Context Protocol(MCP)的后端实现,旨在向大模型客户端(LLM)提供可标准化访问的上下文资源、可注册并执行的工具、以及可渲染的提示模板等能力,支持资源管理、工具注册与执行、以及 Prompts 的渲染与管理。服务器通过 JSON-RPC 与客户端通信,具备会话管理、能力声明,并可通过 Stdio、SSE、WebSocket 等传输协议进行交互。
  • 主要功能点

    • MCP 服务端核心:实现 MCP 的工具注册、请求处理、响应返回等核心能力,支持多种传输协议。
    • 资源与数据存储:使用 Firestore 保存并管理 Agents、Bounties、Escrows、Deposits、Withdrawals 等资源。
    • 工具集合:提供 Escrow、Agent、Admin、Payment、Bounty 等工具,供 LLM 调用与执行。
    • 代理身份与信誉:通过算法计算并暴露代理信誉分、任务统计、Nostr/NIP-05 身份等信息。
    • 支付与交易:实现 USDC、USDT、BTC 等多种支付与提现流程的模拟与管理。
    • 自动化脚本与工具:大量脚本用于注册、推广、测试与运维,如自动化评估、赛题化 bounty、钩子等。
    • MCP 客户端集成示例:提供在 Claude Desktop 等客户端接入的示例配置与使用说明。
  • 安装步骤

    • 进入 MCP 服务端目录并安装依赖:
      • 进入 mcp-server 目录
      • 运行 npm install
      • 运行 npm run build
    • 启动与测试(具体测试命令可参考仓库提供的测试脚本,确保环境变量配置正确,例如 Firestore、支付网关等凭据)。
    • 运行后端服务后,MCP 客户端即可通过 MCP 服务器进行连接与调用。
  • 服务器配置(JSON 配置示例,供 MCP 客户端使用) 说明:MCP 客户端需要一个服务器条目来知道如何启动并连接到 MCP 服务器。以下信息用于描述服务器配置,不是服务器源码本身。 { "server_name": "clawdentials", "command": "npx", "args": ["clawdentials-mcp"] } 注释:

    • server_name: MCP 服务器在客户端中的标识名称,便于在多服务器环境中区分。
    • command: 启动 MCP 服务器所用的命令(客户端需执行的命令)。
    • args: 启动命令的参数,通常为运行 MCP 服务的可执行名或脚本名(在本仓库中示例为 clawdentials-mcp,对应在发布包中可执行的 MCP 服务入口)。 说明:MCP 客户端不需要包含服务器端实现的代码,仅提供服务器启动方式和访问信息即可。
  • 基本使用方法

    • 客户端启动后,可以通过 MCP 提供的工具接口(escrow、agent、bounty、payment 等)来执行相应任务和交互。
    • 服务器端负责执行会话管理、能力声明,以及资源的增删改查、工具调用等,帮助 LLM 实现可预测的上下文和能力访问。
    • 客户端与服务器通信基于 JSON-RPC,支持标准的请求/响应模式,以及通知事件。

服务器信息