MCP 服务器

MPC Tally API Server

一个服务器，允许 AI 代理通过 Tally API 交互，使用模型上下文协议 (MCP) 访问 DAO 治理数据、提案和元数据。该服务器使用 TypeScript 和 GraphQL 构建。

Tools

list-daos

List DAOs on Tally sorted by specified criteria

get-dao

Get detailed information about a specific DAO

list-delegates

List delegates for a specific organization with their metadata

get-delegators

Get list of delegators for a specific address

list-proposals

List proposals for a specific DAO or organization using its slug

get-proposal

Get detailed information about a specific proposal. You must provide either the Tally ID (globally unique) or both onchainId and governorId (unique within a governor).

get-address-votes

Get votes cast by an address for a specific organization

get-address-created-proposals

Get proposals created by an address for a specific organization

get-address-daos-proposals

Returns proposals from DAOs where a given address has participated (voted, proposed, etc.)

get-address-received-delegations

Returns delegations received by an address

get-delegate-statement

Get a delegate's statement for a specific governor or organization

get-address-governances

Returns the list of governances (DAOs) an address has delegated to

get-proposal-timeline

Get the timeline of events for a specific proposal

get-proposal-voters

Get a list of all voters who have voted on a specific proposal

get-address-metadata

Get metadata information about a specific Ethereum address

get-proposal-security-analysis

Get security analysis for a specific proposal, including threat analysis and simulations

get-proposal-votes-cast

Get vote statistics and formatted vote counts for a specific proposal

get-proposal-votes-cast-list

Get a list of votes cast for a specific proposal, including formatted vote amounts

get-governance-proposals-stats

Get statistics about passed and failed proposals for a specific DAO

README

MPC Tally API 服务器

一个用于与 Tally 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

配置

TALLY_API_KEY=your_api_key_here

从 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"