Algorand MCP Implementation

Algorand MCP Implementation

site icon
2025.04.14 27
TypeScript区块链服务DeFi 工具交易处理金融服务
Algorand MCP 是一个基于 Algorand 区块链的模型上下文协议(MCP)实现,旨在为大型语言模型(LLMs)提供标准化的区块链交互工具和资源。该实现包含服务器端和客户端两个主要部分,支持 Algorand 区块链的账户管理、资产操作、交易处理、状态查询等功能,并集成了多个 DeFi 和 DEX 平台。
View on GitHub

Overview

基本能力

产品定位

Algorand MCP 是一个专为 Algorand 区块链设计的模型上下文协议实现,旨在为开发者提供标准化的区块链交互工具和资源,使其能够更高效地与 Algorand 区块链进行交互。

核心功能

  • 区块链交互:支持账户管理、资产操作、应用交互和交易处理。
  • 资源查询:提供全面的区块链状态查询功能,包括实时和历史数据。
  • 集成服务:支持 NFDomains、Vestige DeFi 分析、Tinyman AMM 和 Ultrade DEX 等第三方服务。
  • 标准化响应:所有响应和错误均遵循统一的格式。

适用场景

  • 区块链开发:开发者可以使用 Algorand MCP 快速构建与 Algorand 区块链交互的应用。
  • DeFi 应用:集成 Vestige、Tinyman 和 Ultrade 等 DeFi 工具,支持复杂的金融操作。
  • 钱包管理:客户端工具支持钱包连接和交易签名,适合钱包应用开发。

工具列表

  • 账户管理工具:创建账户、验证地址、密钥转换等。
  • 应用工具:创建、更新、删除应用,以及应用调用等。
  • 资产工具:创建、配置、转移和销毁资产。
  • 交易工具:提交、模拟和签名交易。
  • 资源工具:支持 Algod、Indexer、NFDomains、Vestige、Tinyman 和 Ultrade 的查询和操作。

常见问题解答

  • 依赖问题:确保使用 Node.js v23.6.1 或更高版本,以及 npm v10.2.4 或更高版本。
  • 安装问题:通过 NPM 或 Smithery 安装时,确保配置正确的环境变量。

使用教程

使用依赖

  • Node.js:v23.6.1 或更高版本。
  • npm:v10.2.4 或更高版本。

安装教程

通过 NPM 安装

npm install algorand-mcp

通过 Smithery 安装(Claude Desktop)

npx -y @smithery/cli@latest install @GoPlausible/algorand-mcp --client claude --config "{\"NFD_API_KEY\":\"\",\"NFD_API_URL\":\"https://api.nf.domains\",\"ALGORAND_ALGOD\":\"https://testnet-api.algonode.cloud\",\"ALGORAND_TOKEN\":\"\",\"ITEMS_PER_PAGE\":\"10\",\"VESTIGE_API_KEY\":\"\",\"VESTIGE_API_URL\":\"https://api.vestigelabs.org\",\"ALGORAND_INDEXER\":\"https://testnet-idx.algonode.cloud\",\"ALGORAND_NETWORK\":\"testnet\",\"ALGORAND_ALGOD_API\":\"https://testnet-api.algonode.cloud/v2\",\"ALGORAND_ALGOD_PORT\":\"\",\"ALGORAND_INDEXER_API\":\"https://testnet-idx.algonode.cloud/v2\",\"ALGORAND_INDEXER_PORT\":\"\"}"

通过 Smithery 安装(Cursor)

npx -y @smithery/cli@latest install @GoPlausible/algorand-mcp --client cursor --config "{\"NFD_API_KEY\":\"\",\"NFD_API_URL\":\"https://api.nf.domains\",\"ALGORAND_ALGOD\":\"https://testnet-api.algonode.cloud\",\"ALGORAND_TOKEN\":\"\",\"ITEMS_PER_PAGE\":\"10\",\"VESTIGE_API_KEY\":\"\",\"VESTIGE_API_URL\":\"https://api.vestigelabs.org\",\"ALGORAND_INDEXER\":\"https://testnet-idx.algonode.cloud\",\"ALGORAND_NETWORK\":\"testnet\",\"ALGORAND_ALGOD_API\":\"https://testnet-api.algonode.cloud/v2\",\"ALGORAND_ALGOD_PORT\":\"\",\"ALGORAND_INDEXER_API\":\"https://testnet-idx.algonode.cloud/v2\",\"ALGORAND_INDEXER_PORT\":\"\"}"

调试方式

安装完成后,可以通过以下命令测试服务是否正常运行:

node -e "require('algorand-mcp').server()"

确保所有环境变量已正确配置,特别是 ALGORAND_ALGODALGORAND_INDEXER

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。