使用说明

项目简介

本项目 'sns-mcp-server' 是一个 Model Context Protocol (MCP) 服务器实现,旨在为大型语言模型 (LLM) 客户端提供与 Internet Computer (IC) 上的 Service Nervous System (SNS) DAO 交互的能力。通过此服务器,LLM 可以获取 DAO 的提案列表、用户可投票的神经元信息、系统参数,并代表用户进行投票操作,从而实现基于 LLM 的 DAO 治理助手应用。

主要功能点

  • 列出提案 (list_proposals): 查询指定 DAO 的所有提案。
  • 列出可投票神经元 (list_votable_neurons): 查询指定 DAO 中,特定 Principal ID 用户的可投票神经元列表。
  • 获取系统参数 (get_system_parameters): 查询指定 DAO 的系统配置参数。
  • 获取钱包地址 (wallet): 获取当前服务器配置的钱包 Principal ID。
  • 提案投票 (vote_proposal): 代表用户在指定 DAO 中对提案进行投票(支持赞成、反对、弃权)。

安装步骤

  1. 安装 Node.js 和 npm: 确保你的开发环境中已安装 Node.js 和 npm。
  2. 克隆仓库:
    git clone https://github.com/baolongt/sns-mcp-server.git
    cd sns-mcp-server
  3. 配置环境变量: 复制 '.env.example' 文件并重命名为 '.env',然后编辑 '.env' 文件,填入你的 Seed Phrase。这是服务器用于与 IC 网络交互的钱包密钥,请务必妥善保管。
    cp .env.example .env
    # 编辑 .env 文件,填入 SEED_PHRASE
  4. 安装依赖:
    npm install
  5. 构建服务器:
    npm run build

服务器配置

要将此 MCP 服务器配置到 MCP 客户端(例如 Claude Desktop),你需要提供服务器的启动命令。以下是配置示例,以 JSON 格式添加到客户端的配置文件中(例如 Claude Desktop 的 'claude_desktop_config.json'):

{
  "mcpServers": {
    "sns-mcp-server": {
      "command": "/path/to/sns-mcp-server/build/index.js"
    }
  }
}
  • 'server name': '"sns-mcp-server"' (服务器名称,可以自定义)
  • 'command': '"/path/to/sns-mcp-server/build/index.js"' (服务器启动命令,需要替换 '/path/to/sns-mcp-server' 为你本地仓库的绝对路径)

注意: MCP 客户端通常只需要 'command' 配置项来启动 MCP 服务器,本服务器不需要额外的启动参数。

基本使用方法

成功配置 MCP 服务器后,你的 MCP 客户端将能够检测到 'sns-mcp-server' 并调用其提供的工具。具体使用方法取决于你的 MCP 客户端。

例如,在 Claude Desktop 中,你可能需要在对话中提及工具名称和所需的参数(例如 DAO 名称),Claude 可能会自动调用相应的工具并返回结果。

请参考你的 MCP 客户端的文档,了解如何使用 MCP 服务器以及如何调用和传递参数给 'sns-mcp-server' 提供的工具。

信息

分类

网页与API