AIBlock MCP 服务器

AIBlock MCP 服务器

使用Python、uv和pyproject为AIBlock MCP服务器初始化搭建脚手架。

参考文献

• MCP 概述：https://modelcontextprotocol.io/
• 传输（可流式传输的HTTP）：https://modelcontextprotocol.io/docs/concepts/transports
• MCP Python SDK：https://github.com/modelcontextprotocol/python-sdk
• AIBlock SDK（PyPI）: https://pypi.org/project/aiblock/

快速入门（开发版）

• 环境（Env）
  • cp .env.example .env 并且设定 AIBLOCK_PASSPHRASE可选： MCP_ALLOW_ORIGINS=*（逗号后）主持人。
• 安装
  • uv venv -p 3.11 .venv && source .venv/bin/activate
  • uv sync --extra dev
  • uv pip install -e .
• 跑
  • uv run uvicorn aiblock_mcp.server:app --host 0.0.0.0 --port 8000
• 测试
  • uv run pytest -q
• MCP 检查器（安装与运行）
  • 需要 Node.js 18+ 或 Docker。
  • 选项A（npx，无需安装）：
    • npx @modelcontextprotocol/inspector@latest
  • 选项B（全局安装）：
    • npm install -g @modelcontextprotocol/inspector
    • mcp-inspector
  • 选项C（Docker）：
    • docker run --rm -p 5173:5173 ghcr.io/modelcontextprotocol/inspector:latest
  • 在检查器用户界面中，添加一个服务器：
    • 传输：可流式传输的HTTP
    • URL:（网址：） http://localhost:8000/mcp
    • 如果使用开发者身份验证：设置 MCP_DEV_AUTH_TOKEN 在服务器上并提供 Authorization: Bearer <token> 在检查器请求中。
  • 尝试工具： wallet.generate_seed_phrase， wallet.generate_keypair， wallet.get_balance， blockchain.get_latest_block， health， version。