Vestige MCP

🚀 万古链 MCP

万古链 MCP 由 GoPlausible 开发，从 Algorand MCP 提炼而来。它是一个用于与 Vestige API 交互的模型上下文协议（MCP）服务器实现，为 Algorand 生态系统提供全面的 DeFi 分析和数据访问工具。

🚀 快速开始

万古链 MCP 充当 MCP 启用应用程序与 Vestige API 之间的桥梁，提供网络信息和统计、协议分析、资产数据和价格信息等功能。

✨ 主要特性

• 网络信息：提供 Algorand 网络的整体状态和统计。
• 协议分析：监控和分析 DeFi 协议的使用情况，包括 TVL 和活动数据。
• 资产数据：综合资产信息，包括价格、历史和市场统计数据。
• 交易数据：实时交换监控和历史交易记录。
• 池分析：液性池详细信息，包括组成和绩效指标。

📦 安装指南

要安装或更新万古链 MCP，请按照以下步骤操作：

1. 首先检查 Node.js 版本是否为 23.6.1 或更高：

node -v

如果需要，请升级到 23.6.1 或更高版本。 2. 检查 Claude 或 Cursor 容器文件夹中是否有 mcp - servers 文件夹（如果没有则创建）：

mkdir PATH_ON_YOUR_MACHINE/Claude/mcp-servers
# 或对于 Cursor 
mkdir PATH_ON_YOUR_MACHINE/Cursor/mcp-servers

3. 在 mcp - servers 文件夹下克隆此仓库并安装依赖项：

cd PATH_ON_YOUR_MACHINE/Claude/mcp-servers
# 或对于 Cursor 
cd PATH_ON_YOUR_MACHINE/Cursor/mcp-servers
# 克隆仓库
git clone https://github.com/GoPlausible/vestige-mcp.git
cd vestige-mcp
# 安装依赖项
npm install
# 构建项目
npm run build
# 编辑 .env 文件以设置配置

4. 完成上述步骤后，可在您的 MCP 配置中添加服务器：

{
  "mcpServers": {
    "vestige-mcp": {
      "command": "node",
      "args": [
        "PATH_ON_YOUR_MACHINE/Claude/mcp-servers/vestige-mcp/packages/server/dist/index.js"
     ],
      "env": {
        "ALGORAND_NETWORK": "mainnet",
        "ALGORAND_ALGOD_API": "https://mainnet-api.algonode.cloud/v2",
        "ALGORAND_ALGOD": "https://mainnet-api.algonode.cloud",
        "ALGORAND_ALGOD_PORT": "",
        "ALGORAND_TOKEN": "",
        "ALGORAND_AGENT_WALLET": "problem aim online jaguar upper oil flight stumble mystery aerobic toy avoid file tomato moment exclude witness guard lab opera crunch noodle dune abandon broccoli",
        "VESTIGE_API_URL": "https://api.vestigelabs.org",
        "VESTIGE_API_KEY": "",
        "NODE_ENV": "development"
      }
    }
  }
}

📚 详细文档

项目结构

- packages/
  - server/               # MCP 服务器代码
  - client/              # 可选的 MCP 客户端代码（如果包含）

开发

启动服务器

cd packages/server
npm run dev

贡献

1. 叉仓库
2. 创建功能分支
3. 提交更改
4. 推送到分支
5. 创建 Pull Request

📄 许可证

本项目在 MIT License 下授权，详情请参阅 LICENSE 文件。