返回 MCP 目录
public公开dns本地运行

sns-mcp-server

一个基于TypeScript的MCP服务器,用于与Internet Computer上的DAO交互

article

README

🚀 MCP-SNS-Server 服务器

MCP-SNS-Server 是一个用于与互联网计算机上的 DAO 进行交互的模型上下文协议 (MCP) 服务器。它基于 TypeScript 构建,实现了与服务神经系统 (SNS) DAOs 的接口,为用户提供了与去中心化自主组织互动的工具,通过展示核心 MCP 概念,助力用户更好地参与 DAO 相关事务。

演示

🚀 快速开始

设置

将您的种子短语添加到环境文件中:

cp .env.example .env

✨ 主要特性

工具

  • list_proposals - 列出特定 DAO 的所有提案

    • 参数:接受 DAO 名称作为参数
    • 返回:返回指定 DAO 的提案列表
  • list_votable_neurons - 列出用户在 DAO 中的所有可投票神经元

    • 参数:接收 DAO 名称和用户 ID 作为参数
    • 返回:返回可以对提案投票的神经元
  • get_system_parameters - 列出 DAO 的所有配置参数

    • 参数:接受 DAO 名称作为参数
    • 返回:返回指定 DAO 的系统参数
  • wallet - 获取用户的钱包信息

    • 返回:返回当前钱包的主要 ID
  • vote_proposal - 对提案进行投票

    • 参数:接收 DAO 名称、用户 ID、神经元 ID、提案 ID 和投票偏好
    • 功能:允许对提案投赞成票、反对票或弃权票,并在 DAO 治理系统中记录投票

📦 安装指南

要与 Claude Desktop 一起使用,请在服务器配置中添加以下内容:

  • 在 MacOS 上:~/Library/Application Support/Claude/claude_desktop_config.json
  • 在 Windows 上:%APPDATA%/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "mcp-sns-server": {
      "command": "/path/to/mcp-sns-server/build/index.js"
    }
  }
}

调试

由于 MCP 服务器通过标准输入输出进行通信,调试可能具有挑战性。我们推荐使用 MCP Inspector,它作为包脚本可用:

npm run inspector

Inspector 将提供一个 URL,以便在您的浏览器中访问调试工具。

💻 使用示例

基础用法

# 安装依赖项
npm install

# 构建服务器
npm run build

# 使用自动重建进行开发
npm run watch

高级用法

# 在不同系统的 Claude Desktop 配置文件中添加服务器配置
{
  "mcpServers": {
    "mcp-sns-server": {
      "command": "/path/to/mcp-sns-server/build/index.js"
    }
  }
}
# 使用 MCP Inspector 进行调试
npm run inspector
help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端