MPC 计票API服务器

这是一个用于与计票API交互的模型上下文协议（MCP）服务器。该服务器允许AI代理获取关于DAO的信息，包括其治理数据、提案和元数据。

功能

• 按受欢迎程度或探索状态排序列出DAO
• 获取全面的DAO元数据，包括社交链接和治理信息
• 支持分页以处理大量结果集
• 使用TypeScript和GraphQL构建
• 使用Bun测试运行器进行完整的测试覆盖

安装

# 克隆仓库
git clone https://github.com/yourusername/mpc-tally-api-server.git
cd mpc-tally-api-server

# 安装依赖
bun install

# 构建项目
bun run build

配置

1. 在根目录下创建一个.env文件：

TALLY_API_KEY=your_api_key_here

2. 从Tally获取您的API密钥

⚠️ 安全提示：确保您的API密钥安全：

• 切勿提交您的.env文件
• 不要在日志或错误消息中暴露您的API密钥
• 如果API密钥被泄露，请更换它
• 使用环境变量进行配置

使用方法

运行服务器

# 启动服务器
bun run start

# 开发模式，自动重载
bun run dev

Claude Desktop配置

在您的Claude Desktop配置中添加以下内容：

{
  "tally": {
    "command": "node",
    "args": [
      "/path/to/mpc-tally-api-server/build/index.js"
    ],
    "env": {
      "TALLY_API_KEY": "your_api_key_here"
    }
  }
}

可用脚本

• bun run clean - 清理构建目录
• bun run build - 构建项目
• bun run start - 运行构建好的服务器
• bun run dev - 在开发模式下运行，自动重载
• bun test - 运行测试
• bun test --watch - 在监视模式下运行测试
• bun test --coverage - 带有覆盖率的测试运行

API函数

服务器公开了以下MCP函数：

list_daos

按指定标准列出DAO。

参数：

• limit（可选）：返回的DAO的最大数量（默认：20，最大：50）
• afterCursor（可选）：分页的游标
• sortBy（可选）：如何对DAO进行排序（默认：popular）
  • 选项："id"，"name"，"explore"，"popular"

许可证

MIT