Manifold Markets MCP 服务器使用说明

项目简介

本项目是一个 Model Context Protocol (MCP) 服务器，它充当 LLM 客户端与 Manifold Markets 预测市场平台之间的桥梁。通过此服务器，LLM 客户端可以利用预定义的工具集，以标准化的方式与 Manifold Markets 平台进行交互，实现市场信息的查询、市场交易的执行以及更高级的市场操作。

主要功能点

市场创建与管理: 支持创建多种类型的预测市场 (BINARY, MULTIPLE_CHOICE, PSEUDO_NUMERIC, POLL, BOUNTIED_QUESTION)，以及市场的关闭、取消解决和添加答案等管理功能。
市场互动: 允许用户关注市场、对市场或评论进行点赞/踩踩，以及添加和奖励赏金。
交易操作: 提供下注、取消限价单和出售份额等交易功能。
流动性管理: 支持向市场流动性池添加和移除流动性。
信息检索: 可以搜索市场、获取市场详细信息、用户资料以及用户持仓信息。
社交功能: 支持用户之间转移 Mana 货币。
全面的错误处理: 包括输入验证、API 通信错误和业务逻辑错误处理，确保操作的稳定性和可靠性。

安装步骤

安装 Node.js: 确保您的系统已安装 Node.js 18 或更高版本。
安装 npm 包: 打开终端，导航到您希望安装此服务器的目录，并运行以下命令：
```
npm install manifold-mcp-server
```
获取 Manifold Markets API 密钥:
- 访问 Manifold Markets 并登录您的账户。
- 进入您的个人资料设置页面。
- 生成一个新的 API 密钥。
- 确保您的账户有足够的 Mana 余额以进行市场创建等操作（至少 M$1000）。

服务器配置

MCP 客户端需要配置 MCP 服务器的连接信息。以下是针对 Claude Desktop 和 Cline (VSCode Extension) 的配置示例。您需要根据您的 MCP 客户端类型进行相应配置。

针对 Claude Desktop 的配置 (添加到 '~/Library/Application Support/Claude/claude_desktop_config.json'):

{
  "mcpServers": {
    "manifold": {
      "command": "node",
      "args": ["/path/to/manifold-mcp-server/build/index.js"],
      "env": {
        "MANIFOLD_API_KEY": "your_api_key_here" // 替换为您在 Manifold Markets 获取的 API 密钥
      }
    }
  }
}

'server name': 服务器名称，这里设置为 "manifold"，您可以自定义。
'command': 启动服务器的命令，这里使用 'node' 运行 JavaScript 代码。
'args': 传递给 'node' 命令的参数，指定服务器入口文件路径 '/path/to/manifold-mcp-server/build/index.js'，请替换为实际路径。
'env': 环境变量配置，'MANIFOLD_API_KEY' 用于存储您的 Manifold Markets API 密钥，请务必替换为您的真实密钥。

针对 Cline (VSCode Extension) 的配置 (添加到 '~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json'):

{
  "mcpServers": {
    "manifold": {
      "command": "node",
      "args": ["/path/to/manifold-mcp-server/build/index.js"],
      "env": {
        "MANIFOLD_API_KEY": "your_api_key_here" // 替换为您在 Manifold Markets 获取的 API 密钥
      }
    }
  }
}

配置项含义与 Claude Desktop 相同，请根据您的实际情况进行配置。

基本使用方法

启动 MCP 服务器: 在安装 'manifold-mcp-server' 的目录下，运行 'npm run build' 构建项目，然后根据您的 MCP 客户端配置启动服务器。通常情况下，服务器会在后台运行并通过标准输入/输出与客户端通信。
配置 MCP 客户端: 根据您的 MCP 客户端（如 Claude Desktop 或 Cline）的文档，配置 MCP 服务器连接，填入上面生成的 JSON 配置信息。
通过 MCP 客户端使用工具: 在 MCP 客户端中，您应该能够看到 'manifold-markets' 服务器提供的工具列表。您可以选择相应的工具，填写必要的参数，即可调用 Manifold Markets 平台的各项功能。例如，您可以使用 'create_market' 工具创建新的预测市场，或使用 'place_bet' 工具在现有市场上进行交易。

请参考 Manifold Markets API 文档和 MCP 客户端的指南，了解更详细的工具使用方法和参数说明。

关键词