项目简介

Akash MCP 服务器是一个使用 TypeScript 开发的 Model Context Protocol (MCP) 服务器,它充当 AI 智能体和 Akash 网络之间的桥梁。该服务器允许 AI 模型通过标准化的 MCP 协议,调用预定义的工具,直接与 Akash 网络进行交互,例如部署应用、创建租约、管理部署等。

主要功能点

  • 钱包和客户端管理: 负责 Akash 钱包的认证和客户端的初始化,保障与 Akash 网络的连接。
  • 证书管理: 管理 Akash 证书,用于安全地与 Akash 网络交互。
  • 丰富的工具集: 提供了一系列预置工具,允许 AI 智能体执行以下操作:
    • 账户地址检索: 获取 Akash 账户地址。
    • 部署管理: 创建、管理和查询 Akash 网络上的应用部署。
    • SDL 操作: 处理 Stack Definition Language (SDL),用于定义应用部署配置。
    • 竞价管理: 查询部署的竞价信息。
    • 租约管理: 创建和管理 Akash 网络的资源租约。
    • 服务查询: 获取租约中服务的详细信息。
    • Manifest 部署: 向供应商发送 Manifest 文件以部署应用。
  • Prompt 模板支持: 虽然文档中没有明确提及,但 MCP 服务器通常支持 Prompt 模板,该项目有可能在未来版本中加入此功能,以支持更灵活的 LLM 交互模式。
  • 标准 MCP 接口: 遵循 Model Context Protocol 标准,能够与各种兼容 MCP 协议的 AI 平台和工具集成。
  • Stdio 传输: 默认使用 Stdio 传输协议,易于集成和部署。

安装步骤

  1. 克隆仓库:

    git clone https://github.com/akash-network/mcp.git
    cd mcp
  2. 安装依赖:

    npm install
  3. 构建项目:

    npm run build

服务器配置

为了让 MCP 客户端(如 Claude Desktop 或 Cursor)连接到 Akash MCP 服务器,您需要在客户端的配置文件中添加服务器信息。以下是一个配置示例,通常在 'claude_desktop_config.json' 或 '.cursor/mcp.json' 文件中进行配置:

{
  "mcpServers": {
    "Akash": {
      "command": "node",
      "args": ["<path to dist/index.js>"],
      "env": {
        "AKASH_MNEMONIC": "<your mnemonic here>",
        "AKASH_RPC_URL": "https://rpc.akashnet.net:443" // 可选,默认为 https://rpc.akashnet.net:443
      }
    }
  }
}

配置参数说明:

  • '"Akash"': 服务器名称,可以自定义,用于在客户端中标识该服务器。
  • '"command": "node"': 启动服务器的命令,这里使用 Node.js 运行 JavaScript 文件。
  • '"args": ["<path to dist/index.js>"]': 命令参数,指向编译后的服务器入口文件 'dist/index.js' 的路径。 请务必将 '<path to dist/index.js>' 替换为实际路径。
  • '"env"': 环境变量配置,用于服务器运行时读取:
    • '"AKASH_MNEMONIC": "<your mnemonic here>"': 必填,Akash 钱包的助记词,用于服务器进行交易签名和身份验证。 请务必替换为您的 Akash 钱包助记词。
    • '"AKASH_RPC_URL": "https://rpc.akashnet.net:443"': 可选,Akash 网络的 RPC endpoint URL。 如果不配置,则默认使用 'https://rpc.akashnet.net:443'。

重要提示:

  • 安全性: 请务必妥善保管您的 Akash 钱包助记词,避免泄露。
  • 路径: 确保 '<path to dist/index.js>' 路径正确,指向服务器编译后的入口文件。

基本使用方法

  1. 启动服务器 (开发模式):

    npm run dev

    或 (监听模式,方便开发调试):

    npm run dev:watch
  2. 配置 MCP 客户端: 根据上述 "服务器配置" 部分,在您的 MCP 客户端(如 Claude Desktop 或 Cursor)中配置连接信息。

  3. 在 MCP 客户端中使用工具: 配置完成后,您的 MCP 客户端应该能够检测到 "Akash" 服务器。在客户端中,您可以指示 AI 模型使用服务器提供的工具来与 Akash 网络进行交互。 例如,您可以指示 AI 模型使用 "create-deployment" 工具在 Akash 上部署应用,或者使用 "get-account-addr" 工具获取您的 Akash 账户地址。 具体的工具使用方法请参考各工具的描述信息。

注意: 该项目目前仍处于开发阶段,部分工具可能尚未完善。 请关注项目更新,以获取更多功能和改进。

信息

分类

AI与计算