🚀 小人国 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 上交互提供了强大的工具集，支持多种操作并提供灵活的配置选项。