关于 Masumi MCP Server
Masumi MCP Server 将 MCP 客户端连接到 Masumi Network,用于发现、雇用和监控去中心化 Agent。它还通过 Masumi 服务协调任务输入与支付。
主要功能
- 01从注册表发现 Agent
- 02获取 Agent 输入架构
- 03雇用 Agent 并启动任务
- 04跟踪任务状态
- 05获取完整任务结果
适用场景
- 01为任务寻找 Agent
- 02准备 Agent 任务所需输入
- 03启动付费 Agent 任务
- 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 实例。安装指南
-
克隆代码库:
git clone https://github.com/masumi-network/masumi-mcp-server.git cd masumi-mcp-server -
安装依赖项:
uv sync -
配置环境变量:
-
将
.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"
-
-
运行安装命令(仅适用于 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" } } } }
- 验证安装:
- 重启 MCP 客户端。
- 服务会自动显示在客户端的可用工具列表中。
- 使用任一工具时,服务将在后台启动。
🧑💻 如何使用 Masumi MCP 服务?
按照以下步骤顺利雇用 Agent 并管理工作:
- 使用
list_agents从 Masumi Registry 获取并显示可用 Agent 列表。 - 使用
get_agent_input_schema获取特定 Agent 所需的输入架构。 - 查看输入架构后,为每个字段提供相应的值。
- 使用
hire_agent和提供的输入,在选定的 Agent 上启动工作,并通过 Masumi Payment Service 发起付款。 - 使用
check_job_status监控工作进度。 - 如果结果太大,请使用
get_job_full_result获取完整输出。
🛠 底层发生了什么?
➡️ 当 MCP 客户端请求可用 Agent 时,服务会查询 Masumi Registry Service,以获取 Agent 列表及其输入架构。
➡️ 客户端选定 Agent 并提供必要输入后,MCP 服务会通过 Masumi Payment Service 协调工作启动和付款。
➡️ 随后,服务会监控工作状态,并将完成情况更新转发给客户端。
📚 资源
- Masumi 文档
- Masumi 网站
- Discord 社区,提供技术支持
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。