项目简介
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 传输协议,易于集成和部署。
安装步骤
-
克隆仓库:
git clone https://github.com/akash-network/mcp.git cd mcp -
安装依赖:
npm install -
构建项目:
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>' 路径正确,指向服务器编译后的入口文件。
基本使用方法
-
启动服务器 (开发模式):
npm run dev或 (监听模式,方便开发调试):
npm run dev:watch -
配置 MCP 客户端: 根据上述 "服务器配置" 部分,在您的 MCP 客户端(如 Claude Desktop 或 Cursor)中配置连接信息。
-
在 MCP 客户端中使用工具: 配置完成后,您的 MCP 客户端应该能够检测到 "Akash" 服务器。在客户端中,您可以指示 AI 模型使用服务器提供的工具来与 Akash 网络进行交互。 例如,您可以指示 AI 模型使用 "create-deployment" 工具在 Akash 上部署应用,或者使用 "get-account-addr" 工具获取您的 Akash 账户地址。 具体的工具使用方法请参考各工具的描述信息。
注意: 该项目目前仍处于开发阶段,部分工具可能尚未完善。 请关注项目更新,以获取更多功能和改进。
信息
分类
AI与计算