Tinyman MCP

🚀 小人國 MCP

這是一個由 GoPlausible 開發的，在 Algorand 網絡的 Tinyman 上實現的模型上下文協議 (MCP)。該項目為開發者提供了與 Tinyman AMM 協議在 Algorand 區塊鏈上交互的工具和資源，助力構建更高效的去中心化金融應用。

🚀 快速開始

此項目為與 Tinyman AMM 協議在 Algorand 區塊鏈上交互提供了 MCP 工具和資源。它主要包括兩個主要包：

• @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：支持單資產和雙資產存款的流動性提供報價生成，計算預期池代幣。
• 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 實現，請按以下步驟操作：

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/tinyman-mcp.git
cd tinyman-mcp
# 安裝依賴項
npm install
# 構建項目
npm run build
# 編輯 .env 文件以設置你的配置

4. 完成上述步驟後，你可以打開 MCP 配置並添加服務器：

{
  "mcpServers": {
    "tinyman-mcp": {
      "command": "node",
      "args": [
        "--max-old-space-size=4096"
      ],
      "env": {},
      "volumeMounts": [],
      "dependencies": []
    }
  }
}

📚 詳細文檔

功能特點

• 支持 Tinyman v1.1 和 v2 協議。
• 提供池管理、交易操作和流動性管理功能。
• 兼容 Algorand 網絡的 AMM 生態系統。

項目結構

tinyman-mcp/
├── server.js        # MCP 服務器主文件
├── package.json    # 依賴項和構建配置
└── .env.example    # 環境變量示例

這個項目為與 Tinyman AMM 協議在 Algorand 上交互提供了強大的工具集，支持多種操作並提供靈活的配置選項。