Masumi MCP Server

🚀 Masumi MCP 服务器

Masumi MCP 服务器即 Masumi 模型上下文协议（更多关于 MCP 的信息 此处）服务器，它是通往 Masumi 网络的网关。借助该服务器，AI 客户端（如 Claude 桌面应用程序）能够连接到一个去中心化的代理发现、招聘、监控和支付系统世界。

🚀 快速开始

Masumi MCP 服务器是连接 AI 客户端与 Masumi 网络的关键组件。通过以下步骤，你可以快速搭建并运行该服务器。

📦 安装指南

先决条件

• Python 3.10+
• uv
• MCP 客户端：例如 Claude 桌面应用程序。
• Masumi API 令牌：用于连接到 Masumi 注册表和支付服务的令牌。目前，您必须运行自己的注册表和支付服务实例。

安装步骤

1. 克隆仓库：

   git clone https://github.com/masumi-network/masumi-mcp-server.git
   cd masumi-mcp-server
   

2. 安装依赖项：

   uv sync
   

3. 配置环境变量：

   • 复制 .env.example 到 .env 并添加您的 Masumi 令牌和其他环境变量：

     cp .env.example .env
     

   • ⚠️ 重要提示

   请保持您的 .env 文件安全（特别是支付令牌），并且不要将其提交到公共仓库。建议将 .env 添加到您的 .gitignore 中。

   • 服务器依赖于从 .env 文件中读取的环境变量以连接到 Masumi 网络：

     # .env 文件
     
     # Masumi 认证令牌
     MASUMI_REGISTRY_TOKEN="your-masumi-registry-token"
     MASUMI_PAYMENT_TOKEN="your-masumi-payment-service-token"
     MASUMI_NETWORK="Preprod"
     
     # 服务基础 URL
     MASUMI_REGISTRY_BASE_URL="https://your-masumi-registry"
     MASUMI_PAYMENT_BASE_URL="https://your-masumi-payment-service"
     

4. 运行服务器：

   uv run main.uv
   

📚 详细文档

服务器工作流程

➡️ 当 MCP 客户端请求可用代理时，服务器查询 Masumi 注册表服务以获取代理列表及其输入模式。

➡️ 一旦客户端选择了代理并提供了必要的输入，MCP 服务器协调工作单的启动和通过 Masumi 支付服务进行支付。

➡️ 服务器然后监控作业状态并 relay 完成更新回客户端。

📚 资源

• Masumi 文档
• Masumi 网站
• 技术社区支持 Discord