Algorand Remote MCP

Algorand远程MCP

一个模型上下文协议（MCP）服务器，为AI代理提供与Algorand区块链交互的工具和资源。基于Cloudflare Workers构建，具有基于HashiCorp Vault的钱包管理和多提供商OAuth身份验证。

概述

Algorand Remote MCP通过标准化的MCP接口连接AI代理和Algorand区块链生态系统。它使人工智能系统能够管理钱包、创建和提交交易、通过DEX聚合器交换代币以及访问区块链数据——所有这些都不需要深厚的区块链专业知识。

这是一个 远程MCP 在Cloudflare Workers上运行的实现具有：

• HashiCorp保险库 用于安全的Ed25519密钥存储和交易签名
• 多提供商OAuth （谷歌、GitHub、推特、领英）用于用户身份验证
• algosdk v3.5.2 用于Algorand SDK操作
• Haystack路由器 跨Tinyman、Pact、Folks和LST协议实现最优价格的DEX聚合
• Tinyman SDK 用于直接DEX掉期操作
• Alpha Arcade SDK 用于预测市场交易（订单簿、限价/市价单、头寸）

快速开始

先决条件： Node.js v16+，OAuth帐户（谷歌、GitHub、推特或领英）

添加到MCP客户端配置中：

{
  "mcpServers": {
    "algorand-remote-mcp": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://algorandmcp.goplausible.xyz/sse"
      ]
    }
  }
}

重新启动LLM代理并提示：

Read Algorand MCP skill.

建筑

┌─────────────────────────────────────────────────────────────────────────────┐
│                              AI Agents / LLM Clients                       │
│                    (Claude, GPT, Cursor, Windsurf, etc.)                    │
└─────────────────────────────┬───────────────────────────────────────────────┘
                              │ MCP Protocol (SSE / Streamable HTTP)
                              ▼
┌─────────────────────────────────────────────────────────────────────────────┐
│                     Cloudflare Workers — Edge Runtime                       │
│  ┌───────────────────────────────────────────────────────────────────────┐  │
│  │                        OAuthProvider Layer                            │  │
│  │          Google · GitHub · Twitter · LinkedIn (Multi-provider)        │  │
│  └───────────────────────────┬───────────────────────────────────────────┘  │
│                              ▼                                              │
│  ┌───────────────────────────────────────────────────────────────────────┐  │
│  │              AlgorandRemoteMCP (McpAgent / McpServer)                 │  │
│  │                                                                       │  │
│  │  ┌─────────────── Tool Managers ───────────────────────────────────┐  │  │
│  │  │                                                                 │  │  │
│  │  │  walletManager ─── accountManager ─── utilityManager            │  │  │
│  │  │  transactionManager/                                            │  │  │
│  │  │    ├── generalTransaction   (pay, sign, submit, keyreg)         │  │  │
│  │  │    ├── assetTransactions    (ASA create, optin, transfer)       │  │  │
│  │  │    ├── appTransactions      (create, update, delete, call)      │  │  │
│  │  │    └── groupTransactions    (atomic groups)                     │  │  │
│  │  │  algodManager ─── knowledgeManager                              │  │  │
│  │  │  arc26Manager ─── receiptManager ─── ap2Manager                 │  │  │
│  │  │  tinymanManager ─── alphaArcadeManager                          │  │  │
│  │  │  apiManager/                                                    │  │  │
│  │  │    ├── algod/       (account, application, asset, txn queries)  │  │  │
│  │  │    ├── indexer/     (search & lookup across all data types)     │  │  │
│  │  │    ├── hayrouter/   (DEX aggregator — quote, swap, optin)      │  │  │
│  │  │    └── nfd/         (Algorand Name Service lookups)            │  │  │
│  │  └─────────────────────────────────────────────────────────────────┘  │  │
│  │                                                                       │  │
│  │  ┌─────────────── Resources ───────────────────────────────────────┐  │  │
│  │  │  algorand://remote-mcp-skill         (Skill definition)        │  │  │
│  │  │  algorand://knowledge/taxonomy       (Knowledge base)          │  │  │
│  │  │  algorand://knowledge/taxonomy/{cat} (Category docs)           │  │  │
│  │  └─────────────────────────────────────────────────────────────────┘  │  │
│  │                                                                       │  │
│  │  ┌─────────────── Utils ───────────────────────────────────────────┐  │  │
│  │  │  ResponseProcessor (pagination, BigInt-safe JSON)               │  │  │
│  │  │  vaultManager (Vault API client)                                │  │  │
│  │  │  Skill.js (skill content)                                       │  │  │
│  │  └─────────────────────────────────────────────────────────────────┘  │  │
│  └───────────────────────────────────────────────────────────────────────┘  │
│                                                                             │
│  ┌─────────────── Cloudflare Bindings ────────────────────────────────────┐ │
│  │  Durable Objects (session state)  ·  KV (OAuth tokens, client reg)    │ │
│  │  R2 Bucket (knowledge documents)  ·  Service Bindings (Vault worker)  │ │
│  └────────────────────────────────────────────────────────────────────────┘ │
└──────────┬──────────────────┬──────────────────┬──────────────────┬─────────┘
           │                  │                  │                  │
           ▼                  ▼                  ▼                  ▼
┌──────────────────┐ ┌────────────────┐ ┌────────────────┐ ┌───────────────┐
│  HashiCorp Vault │ │  Algorand Node │ │  DEX & Markets │ │  External APIs│
│  (CF Worker)     │ │  (Algod +      │ │                │ │               │
│                  │ │   Indexer)     │ │  Haystack      │ │  NFD API      │
│  Ed25519 keypair │ │                │ │  Router        │ │  Pera API     │
│  generation      │ │  Nodely.io /   │ │  ┌──────────┐  │ │  Alpha Arcade │
│  Transit engine  │ │  AlgoNode      │ │  │ Tinyman  │  │ │  API          │
│  signing         │ │                │ │  │ Pact     │  │ │               │
│  No private key  │ │  MainNet /     │ │  │ Folks    │  │ │               │
│  exposure        │ │  TestNet       │ │  │ LST      │  │ │               │
│                  │ │                │ │  └──────────┘  │ │               │
└──────────────────┘ └────────────────┘ │                │ └───────────────┘
                                        │  Tinyman SDK   │
                                        │  Alpha Arcade  │
                                        │  SDK           │
                                        └────────────────┘

组件摘要

• AlgorandRemoteMCP：主MCP代理在Cloudflare Workers上扩展McpAgent
• OAuthProvider：多提供商身份验证层（谷歌、GitHub、推特、领英）
• 工具经理：15名专业经理，负责账户、钱包、交易、资产、应用程序、API、DEX操作、预测市场、ARC-26 URI、收据、AP2协议和知识
• 资源提供程序：通过R2基于URI访问技能定义和知识库
• 响应处理器：具有分页和BigInt安全序列化的标准化响应格式
• HashiCorp保险库：Ed25519密钥对生成和通过Transit引擎进行安全签名——无私钥泄露
• Cloudflare绑定：会话状态的持久对象，OAuth的KV，知识文档的R2，Vault worker的服务绑定

工具

账户管理

钱包管理

交易操作

资产运营

应用程序（智能合约）操作

DEX-Haystack路由器（DEX聚合器）

DEX--Tinyman

阿尔及利亚API

Pera钱包资产验证

索引器API

NFD（Algorand名称服务）

TEAL运营

实用工具

ARC-26 URI和收据

AP2协议

阿尔法街机（预测市场）

知识库

资源

知识资源

技能

发展

先决条件

• Node.js v16+
• Cloudflare Workers帐户
• Algorand节点访问（例如Nodely.io/AlgoNode）
• OAuth凭据（谷歌、GitHub、推特和/或领英）
• HashiCorp Vault工作人员用于安全密钥管理

环境变量

ALGORAND_NETWORK=mainnet
ALGORAND_ALGOD=https://your-algod-node.com
ALGORAND_INDEXER=https://your-indexer-node.com
ALGORAND_TOKEN=your-api-token
NFD_API_URL=https://api.nf.domains
HAYSTACK_API_KEY=your-haystack-api-key
ALPHA_API_KEY=your-alpha-arcade-api-key           # Optional, enables richer market data
ALPHA_API_BASE_URL=https://platform.alphaarcade.com/api  # Optional, default shown
GOOGLE_CLIENT_ID=your-google-client-id
GOOGLE_CLIENT_SECRET=your-google-client-secret
HCV_WORKER_URL=https://your-hashicorp-vault-worker.workers.dev

脚本

npm run dev          # Start local development server
npm run type-check   # Run TypeScript type checking
npm run deploy       # Deploy to Cloudflare Workers
npm run format       # Format code with Biome
npm run lint:fix     # Lint and auto-fix with Biome

部署

1. 克隆存储库
2. 安装依赖项： npm install
3. 在中配置环境变量 wrangler.toml
4. 部署： npm run deploy

使用流程

认证

1. 用户通过OAuth（谷歌、GitHub、推特或领英）进行身份验证
2. 服务器从HashiCorp Vault创建或检索钱包凭据
3. 用户通过MCP接口访问工具和资源
4. 用户可以使用注销 wallet_logout

个别交易

1. 创建交易（例如。， sdk_txn_payment_transaction)
2. 用保险库签名(wallet_sign_transaction)或助记符(sdk_sign_transaction)
3. 提交到网络(sdk_submit_transaction)

原子事务组

1. 创建组(sdk_create_atomic_group)
2. 签名组(wallet_sign_atomic_group 或 sdk_sign_atomic_group)
3. 提交组(sdk_submit_atomic_group)

DEX通过Haystack路由器交换

1. 获得最佳报价(haystack_get_swap_quote)
2. 执行掉期操作——在一次通话中报价、保管签名、提交和确认(haystack_execute_swap)

DEX通过Tinyman进行互换

1. 执行固定输入或固定输出交换(tinyman_fixed_input_swap / tinyman_fixed_output_swap)

通过Alpha Arcade预测市场

1. 浏览市场(alpha_get_live_markets)
2. 查看订单簿(alpha_get_orderbook)
3. 下单(alpha_create_limit_order 或 alpha_create_market_order)
4. 监视器位置(alpha_get_positions)和未结订单(alpha_get_open_orders)
5. 管理订单--修改(alpha_amend_order)或取消(alpha_cancel_order)
6. 从已解决的市场中索赔奖金(alpha_claim)

项目结构

src/
├── index.ts                      # Main entry point
├── types.ts                      # Type definitions
├── oauth-handler.ts              # OAuth authentication handler
├── workers-oauth-utils.ts        # OAuth utilities
├── resources/
│   ├── skill/                    # Skill resource
│   └── knowledge/                # Knowledge base resources
├── tools/
│   ├── accountManager.ts         # Account management
│   ├── algodManager.ts           # Algorand node tools
│   ├── ap2Manager.ts             # AP2 protocol tools
│   ├── arc26Manager.ts           # ARC-26 URI and QR tools
│   ├── knowledgeManager.ts       # Knowledge base tools
│   ├── receiptManager.ts         # Transaction receipt tools
│   ├── tinymanManager.ts         # Tinyman DEX tools
│   ├── alphaArcadeManager.ts     # Alpha Arcade prediction market tools
│   ├── utilityManager.ts         # Utility tools
│   ├── walletManager.ts          # Wallet management tools
│   ├── apiManager/
│   │   ├── algod/                # Algod API tools (account, application, asset, transaction)
│   │   ├── hayrouter/            # Haystack Router DEX aggregator tools
│   │   ├── indexer/              # Indexer API tools (account, application, asset, transaction)
│   │   └── nfd/                  # NFD name service tools
│   └── transactionManager/
│       ├── generalTransaction.ts # Payment, signing, submission, key registration
│       ├── appTransactions.ts    # Application (smart contract) transactions
│       ├── assetTransactions.ts  # Asset create, optin, transfer
│       └── groupTransactions.ts  # Atomic transaction groups
└── utils/
    ├── Skill.js                  # Skill content
    ├── vaultManager.ts           # HashiCorp Vault integration
    └── responseProcessor.ts      # Response formatting and pagination

关键依赖关系

贡献

1. 分叉存储库
2. 创建特征分支： git checkout -b feature/my-new-feature
3. 提交您的更改： git commit -am 'Add some feature'
4. 推到分支： git push origin feature/my-new-feature
5. 提交拉取请求

许可证

此项目根据MIT许可证获得许可-有关详细信息，请参阅许可证文件。