Tinyman MCP

Tinyman MCP

GoPlausible が開発した、Algorand 上の Tinyman 向け Model Context Protocol（MCP）実装です。

概要

このプロジェクトは、Algorand ブロックチェーン上の Tinyman AMM プロトコルとやり取りするための MCP ツールとリソースを提供します。主に次の 2 つのパッケージで構成されています。

• @tinyman-mcp/server：スワップ、流動性の提供、プール管理、分析などの Tinyman 操作向けツールを提供する MCP サーバー実装
• @tinyman-mcp/client：ウォレット接続とトランザクション署名向けのクライアント実装（開発中）

機能

MCP サーバーは次のツールを提供します。

プール管理

• tinyman_get_pool：特定のプールに関する詳細情報を取得します
• tinyman_get_pool_analytics：プールの分析情報と統計情報を取得します
• tinyman_get_pool_creation_quote：新しいプールを作成するための見積もりを生成します

取引操作

• tinyman_get_swap_quote：次の方式に対応した、アセットスワップの見積もりを生成します
  • 入力量固定のスワップ
  • 出力量固定のスワップ
  • スリッページの計算

流動性管理

• tinyman_get_liquidity_quote：流動性を追加するための見積もりを生成します
  • 単一アセットおよび 2 種類のアセットの預け入れに対応します
  • 受け取るプールトークンの予測量を計算します
• tinyman_get_remove_liquidity_quote：流動性を解除するための見積もりを生成します
  • 比例配分と単一アセットでの引き出しに対応します
  • 受け取るアセットの予測量を計算します

アセット操作

• tinyman_get_asset_optin_quote：アセットへのオプトインの見積もりを生成します
• tinyman_get_validator_optin_quote：バリデーターへのオプトインの見積もりを生成します
• tinyman_get_validator_optout_quote：バリデーターからのオプトアウトの見積もりを生成します

すべてのツールは Tinyman v1.1 と v2 の両プロトコルに対応しており、該当する場合は v2 がデフォルトのバージョンです。

インストール

Tinyman 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/tinyman-mcp.git
cd tinyman-mcp
# Install dependencies
npm install
# Build the project
npm run build
# Edit the .env file to set your configurations

これで完了です。MCP 設定を開き、次のようにサーバーを追加してください。

{
  "mcpServers": {
    "tinyman-mcp": {
      "command": "node",
      "args": [
        "PATH_ON_YOUR_MACHINE/Claude/mcp-servers/tinyman-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",
        "ITEMS_PER_PAGE": "10"

      }
    }
  }
}

パスは、ローカルシステムのパスに合わせて変更してください。

たとえば、MACOS と Claud の場合、パスは次のようになります。

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

プロジェクト構成

packages/
  ├── client/         # Client implementation (WIP)
  └── server/         # MCP server implementation

開発

# Install dependencies
npm install

# Build all packages
npm run build

# Clean build artifacts
npm run clean

ライセンス

MIT