Vestige MCP

Vestige MCP

由 GoPlausible 构建，基于 Algorand MCP 提炼而成。

一个用于与 Vestige API 交互的模型上下文协议（MCP）服务实现，为 Algorand 生态系统提供全面的 DeFi 分析和数据访问能力。

概览

Vestige MCP 作为 MCP 启用型应用与 Vestige API 之间的桥梁，提供以下工具：

• 网络信息和统计数据
• 协议分析（Tinyman、Pact、Algofi 等）
• 资产数据和价格信息
• 流动性池分析和流动性信息
• 金库统计数据
• 余额跟踪
• 交易监控
• 市场备注和注释

安装

要安装或更新 Algorand MCP 实现，请克隆代码仓库、安装依赖项并构建项目：

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

node -v

如有需要，请升级到 23.6.1 或更高版本！

然后检查 Claude 或 Cursor 容器文件夹中是否有 mcp-servers 文件夹（如果没有，请创建一个）：

mkdir PATH_ON_YOUR_MACHINE/Claude/mcp-servers
# or for Cursor 
mkdir PATH_ON_YOUR_MACHINE/Cursor/mcp-servers

然后在 mcp-servers 文件夹下克隆此代码仓库并安装依赖项：

cd PATH_ON_YOUR_MACHINE/Claude/mcp-servers
# or for Cursor 
cd PATH_ON_YOUR_MACHINE/Cursor/mcp-servers
# Clone the repository
git clone https://github.com/GoPlausible/vestige-mcp.git
cd vestige-mcp
# Install dependencies
npm install
# Build the project
npm run build
# Edit the .env file to set your configurations

完成！现在可以打开 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": "",
        "ITEMS_PER_PAGE": "10"

      }
    }
  }
}

请务必将路径更改为与你本地系统路径相符的值。

例如，在 MACOS 和 Claud 上，路径可能如下所示：

{
  "mcpServers": {
    "vestige-mcp": {
      "command": "node",
      "args": [
        " /Users/YOUR_USERNAME/Library/Application\ Support/Claude/mcp-servers/vestige-mcp/packages/server/dist/index.js"
     ]
    }
  }
}

项目结构

vestige-mcp/
├── packages/
│   ├── client/               # Client library for Vestige MCP (Work in Progress)
│   │   ├── src/
│   │   │   ├── env.ts       # Client environment configuration
│   │   │   ├── index.ts     # Client entry point
│   │   │   └── LocalWallet.ts
│   │   └── package.json
│   │
│   └── server/              # MCP server implementation
│       ├── src/
│       │   ├── tools/       # API tool implementations
│       │   │   └── apiManager/
│       │   │       └── vestige/  # Vestige API endpoints
│       │   ├── utils/       # Utility functions
│       │   ├── resources/   # Resource definitions
│       │   ├── env.ts       # Server environment configuration
│       │   └── index.ts     # Server entry point
│       └── package.json

功能

网络分析

• 查看网络状态和统计数据
• 跟踪区块链同步情况
• 监控网络性能

协议跟踪

• 访问主要 DeFi 协议的数据
• 跟踪总锁定价值（TVL）
• 监控协议活动和使用情况

资产分析

• 全面的资产信息
• 价格跟踪和历史记录
• 交易量和流动性指标
• 市值数据
• 资产构成分析

交易数据

• 实时监控兑换交易
• 历史交易数据
• 价格图表和蜡烛图
• 订单簿深度

流动性池分析

• 流动性池信息
• 流动性池构成
• 交易量和 TVL 跟踪
• 流动性池历史数据

开发

启动服务

cd packages/server
npm run dev

贡献

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

许可证

本项目基于 MIT 许可证授权，详情请参阅 LICENSE 文件。