项目简介
该项目是一个基于 Model Context Protocol (MCP) 构建的服务器,旨在为大型语言模型 (LLM) 客户端提供访问 Snapshot.org 治理平台数据的能力。通过此服务器,LLM 可以调用预定义工具,获取 Snapshot 上的空间 (Spaces)、提案 (Proposals) 和用户 (Users) 等信息,从而增强 LLM 在去中心化治理领域的应用能力。
主要功能点
- 提供 Snapshot 数据访问工具: 内置多个工具,允许 LLM 客户端查询 Snapshot.org 平台上的治理信息,包括:
- 获取空间列表 ('getSpaces')
- 获取排名空间列表 ('getRankedSpaces')
- 获取提案列表 ('getProposals')
- 获取单个提案详情 ('getProposal')
- 获取用户信息 ('getUser')
- MCP 协议兼容: 完全遵循 MCP 协议规范,使用 JSON-RPC over Stdio 与客户端通信,易于集成到支持 MCP 协议的 LLM 应用中。
- 可扩展性: 基于模块化设计,易于扩展和添加新的工具,以支持更多 Snapshot.org 或其他数据源的访问。
安装步骤
- 克隆仓库:
git clone https://github.com/crazyrabbitLTC/mcp-snapshot-server.git cd mcp-snapshot-server - 安装依赖:
确保已安装 Node.js 和 npm,然后运行:
npm install - 构建项目:
构建成功后,会在 'build' 目录下生成服务器代码。npm run build
服务器配置
要将此 MCP 服务器配置到 MCP 客户端(例如 Claude Desktop),您需要提供服务器的启动命令和参数。以下是一个配置示例,适用于 'claude_desktop_config.json' 文件:
{ "mcpServers": { "snapshot": { // 服务器名称,可以自定义 "command": "node", // 启动命令,使用 Node.js 运行 "args": [ "/ABSOLUTE/PATH/TO/mcp-snapshot-server/build/index.js" // 服务器入口文件绝对路径,请替换为实际路径 ] } } }
注意: 请将 '/ABSOLUTE/PATH/TO/mcp-snapshot-server/build/index.js' 替换为 'mcp-snapshot-server' 项目 'build/index.js' 文件的实际绝对路径。您可以通过 'pwd' 命令 (Linux/macOS) 或 'Get-Location' 命令 (Windows PowerShell) 获取当前目录的绝对路径,然后拼接上 'build/index.js'。
基本使用方法
-
启动 MCP 服务器: MCP 服务器通常由 MCP 客户端(如 Claude Desktop)自动启动。当客户端需要调用服务器提供的工具时,会自动根据配置启动服务器进程。
-
在 LLM 客户端中使用工具: 在支持 MCP 协议的 LLM 客户端中,您可以指示 LLM 使用 'snapshot' 服务器提供的工具来查询 Snapshot 数据。例如,在 Claude Desktop 中,您可以向 Claude 提出类似以下指令:
请使用 snapshot 服务器的 getSpaces 工具查询 Snapshot 空间列表。LLM 客户端会将您的指令转换为对 MCP 服务器的工具调用请求,服务器执行工具后会将结果返回给客户端,最终呈现给您。
信息
分类
网页与API