小人国 MCP

这是由 GoPlausible 开发的 Tinyman 上 Algorand 网络上的模型上下文协议 (MCP) 实现。

概述

此项目为与 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 实现，请先检查 Node.js 版本是否为 23.6.1 或更高：

node -v

如果需要升级到 23.6.1 或更高版本！

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

mkdir PATH_ON_YOUR_MACHINE/Claude/mcp-servers
# 或对于 Cursor 
mkdir PATH_ON_YOUR_MACHINE/Cursor/mcp-servers

然后在 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 文件以设置你的配置

完成！现在你可以打开 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 上交互提供了强大的工具集，支持多种操作并提供灵活的配置选项。