AI导哈

Tinyman MCP服务器

一个为Algorand上的Tinyman协议提供模型上下文协议（MCP）服务的服务器，支持流动性池管理、资产交换和流动性提供等功能。

  • by GoPlausible
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 GoPlausible/tinyman-mcp

使用说明

@tinyman mcp/服务器

MCP服务器实现 Tinyman Algorand的行动。建造于 很可能.

概述

此包实现了一个模型上下文协议（MCP）服务器，该服务器提供了与 Tinyman AMM协议。它使AI模型能够执行以下操作：

  • 池管理和分析
  • 资产互换
  • 流动性提供和移除
  • 资产选择加入

安装

要安装或更新Tinyman MCP实现，请克隆存储库，安装依赖项并构建项目”：

第一次检查节点版本为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"

      }
    }
  }
}

确保yopu更改路径以匹配本地系统的路径。

例如，在MACOS和Claud上，路径如下：

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

特性

可用工具

服务器提供以下MCP工具：

游泳池管理

  • tinyman_get_pool

    • 检索特定流动性池的详细信息
    • 包括当前准备金、费用和协议版本
    • 参数：asset1Id、asset2Id、版本（可选，默认为v2）

  • tinyman_get_pool_analytics

    • 获取池的分析和统计信息
    • 包括销量、TVL和价格历史记录
    • 参数：池地址、时间范围（可选）

  • tinyman_get_pool_creation_quote

    • 生成创建新流动性池的报价
    • 计算所需的最低流动性
    • 参数：asset1Id、asset2Id、版本（可选）

交易操作

  • tinyman_get_swap_quote
    • 为资产互换生成报价
    • 支持固定输入和固定输出模式
    • 计算价格影响和滑点
    • 参数：
      • 数量
      • 资产
      • 阿塞图特
      • slippagePct（可选）
      • fixedMode（输入/输出）
      • 版本（可选）

流动性管理

  • tinyman_get_liquidity_quote

    • 生成报价以增加流动性
    • 支持单一和双重资产存款
    • 计算预期的池令牌
    • 参数：
      • 资产1金额
      • 资产2金额
      • 资产Id
      • 资产Id
      • slippagePct（可选）

  • tinyman_get_remove_liquidity_quote

    • 生成用于消除流动性的报价
    • 支持按比例和单一资产提款
    • 计算预期资产回报
    • 参数：
      • poolTokenAmount
      • 池地址
      • singleAssetMode（可选）
      • slippagePct（可选）

资产运营

  • tinyman_get_asset_optin_quote

    • 生成选择资产的报价
    • 参数：assetId

  • tinyman_get_validator_optin_quote

    • 生成选择验证器的报价
    • 参数：验证器AppId

  • tinyman_get_validator_optout_quote

    • 生成退出验证器的报价
    • 参数：验证器AppId

所有工具都支持Tinyman v1.1和v2协议，v2是默认版本（如适用）。工具返回可用于构建和提交交易的标准化报价对象。

资源

服务器提供以下资源：

  • 钱包管理
  • 交易签名
  • 区块链交互

安装

npm install @tinyman-mcp/server

用法

服务器可以使用以下方式运行：

node dist/index.js

它根据MCP协议规范使用stdio进行通信。

环境变量

  • ALGORAND_NODE：Algorand节点URL
  • ALGORAND_TOKEN：Algorand节点API令牌
  • ALGORAND_PORT：Algorand节点端口
  • NETWORK：要使用的网络（默认为 mainnet)

发展

# Install dependencies
npm install

# Build
npm run build


# Clean build artifacts
npm run clean

码头工人

Docker文件用于容器化部署：

# Build image
docker build -t tinyman-mcp-server .

# Run container
docker run -it --rm \
  --env-file .env \
  tinyman-mcp-server

许可证

麻省理工学院

相关 MCP