Tinyman MCP

Tinyman MCP

由 GoPlausible 为 Algorand 上的 Tinyman 构建的模型上下文协议（MCP）实现。

概述

此项目提供用于与 Algorand 区块链上的 Tinyman AMM 协议交互的 MCP 工具和资源。它由两个主要软件包组成：

• @tinyman-mcp/server：MCP 服务实现，提供用于 Tinyman 操作的工具，例如兑换、提供流动性、池管理和分析
• @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 实现，请克隆仓库、安装依赖并构建项目：

首先检查 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