Vestige MCP

Vestige MCP

GoPlausible が開発し、Algorand MCP をもとに作成しました。

Vestige API と連携するための Model Context Protocol（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 と Claude の場合、パスは次のようになります。

{
  "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. プルリクエストを作成します

ライセンス

このプロジェクトは MIT License のもとでライセンスされています。詳細は LICENSE ファイルをご覧ください。