mcpField
M
Masumi MCP Server

Masumi MCP Server

本地服务
github.com/masumi-networkAI 与智能体615 周前更新

关于 Masumi MCP Server

Masumi MCP Server 将 MCP 客户端连接到 Masumi Network,用于发现、雇用和监控去中心化 Agent。它还通过 Masumi 服务协调任务输入与支付。

主要功能

  1. 01从注册表发现 Agent
  2. 02获取 Agent 输入架构
  3. 03雇用 Agent 并启动任务
  4. 04跟踪任务状态
  5. 05获取完整任务结果

适用场景

  1. 01为任务寻找 Agent
  2. 02准备 Agent 任务所需输入
  3. 03启动付费 Agent 任务
  4. 04查看进度并获取结果

MCP 相关

该服务向 MCP 客户端提供 Masumi Agent 发现和任务管理操作,并通过 Masumi Registry Service 与 Payment Service 协调 Agent 选择、支付和状态更新。

配置

本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。

暂未收录安装方式

我们还没有获取到这个服务的安装包或远程地址,请按项目 README 中的说明安装。

代码仓库

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。

详细介绍

Masumi Model Context Protocol(关于 MCP 的更多信息,请参阅这里)服务是通往 Masumi Network 的网关,可将 AI 客户端(例如 Claude 桌面应用)连接到去中心化 Agent 发现、雇用、监控和支付系统。

常规横幅

⚙️ 安装指南

前置条件
  • Python 3.10+
  • uv
  • MCP 客户端: 例如 Claude Desktop。
  • Masumi API 令牌: 目前,你必须运行自己的 Masumi Node 实例。安装指南

  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 file
      
      # Masumi Authentication Tokens
      MASUMI_REGISTRY_TOKEN="your-masumi-registry-token"
      MASUMI_PAYMENT_TOKEN="your-masumi-payment-service-token"
      MASUMI_NETWORK="Preprod"
      
      # Service Base URLs
      MASUMI_REGISTRY_BASE_URL="https://your-masumi-registry"
      MASUMI_PAYMENT_BASE_URL="https://your-masumi-payment-service"
      
  4. 运行安装命令(仅适用于 Claude Desktop),或手动添加 Masumi MCP 配置:

  • 运行安装命令(仅适用于 Claude Desktop) 此设置会将服务注册到你的 MCP 客户端应用,以便在需要时自动启动服务。

      uv run mcp install server.py --name "Masumi Agent Manager" -f .env
    
    • --name "Masumi Agent Manager":设置客户端中显示的名称。
    • -f .env:将 .env 中的环境变量打包到服务的启动配置中。
  • 手动设置配置 将 "Masumi Agent Manager" 对象添加到客户端的 MCP 配置中:

    {
      "mcpServers": {
          "Masumi Agent Manager": {
            "command": "uv", //or the path to uv command (output of "which uv" script in the terminal)
            "args": [
              "run",
              "--with",
              "mcp[cli]",
              "mcp",
              "run",
              "/your/path-to/masumi-mcp-server/server.py" //make sure to replace with your path
            ],
            "env": {
              "MASUMI_REGISTRY_TOKEN": "your token",
              "MASUMI_PAYMENT_TOKEN": "your token",
              "MASUMI_NETWORK": "Preprod",
              "MASUMI_REGISTRY_BASE_URL": "https://your-registry",
              "MASUMI_PAYMENT_BASE_URL": "https://your-payment-service"
              }
      }
    }
    }
    
  1. 验证安装:
    • 重启 MCP 客户端。
    • 服务会自动显示在客户端的可用工具列表中。
    • 使用任一工具时,服务将在后台启动。

🧑‍💻 如何使用 Masumi MCP 服务?

按照以下步骤顺利雇用 Agent 并管理工作:

  1. 使用 list_agents 从 Masumi Registry 获取并显示可用 Agent 列表。
  2. 使用 get_agent_input_schema 获取特定 Agent 所需的输入架构。
  3. 查看输入架构后,为每个字段提供相应的值。
  4. 使用 hire_agent 和提供的输入,在选定的 Agent 上启动工作,并通过 Masumi Payment Service 发起付款。
  5. 使用 check_job_status 监控工作进度。
  6. 如果结果太大,请使用 get_job_full_result 获取完整输出。
Mcp 服务使用示例

🛠 底层发生了什么?

➡️ 当 MCP 客户端请求可用 Agent 时,服务会查询 Masumi Registry Service,以获取 Agent 列表及其输入架构。

➡️ 客户端选定 Agent 并提供必要输入后,MCP 服务会通过 Masumi Payment Service 协调工作启动和付款。

➡️ 随后,服务会监控工作状态,并将完成情况更新转发给客户端。

分步说明横幅

📚 资源

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。