关键词

AI 数据访问上下文协议工具调用去中心化治理LLM 后端

使用说明

项目简介

Axone MCP 服务器是 Axone 提供的 Model Context Protocol (MCP) 服务器实现，它作为 AI 驱动工具访问数据层（dataverse）的网关。该服务器基于标准化的 MCP 协议，旨在简化和统一 AI 应用与后端数据及功能的集成方式。Axone MCP 服务器特别强调了授权层，确保数据访问和功能调用符合链上建立的去中心化治理规则，为 LLM 应用提供安全保障。

主要功能点

  • 资源管理: 虽然代码中没有直接体现资源管理的具体实现，但根据项目描述 "gateway to the dataverse" 可以推断，Axone MCP 服务器的核心功能之一是托管和管理各种数据资源，并为客户端提供访问这些资源的能力。
  • 工具注册与执行: 服务器支持注册和执行外部工具，允许 LLM 客户端通过 MCP 协议调用这些工具来扩展自身的功能。示例代码中包含了一个 'hello_world' 工具，展示了工具的注册和调用机制。
  • Prompt 模板: 虽然代码中没有直接展示 Prompt 模板功能，但作为 MCP 服务器的标准功能，并且在项目描述中提及 "gateway to the dataverse for AI-powered tools"，可以推测服务器具备定义和渲染 Prompt 模板的能力，以支持定制化的 LLM 交互模式 (具体实现可能在代码未展示部分或集成在 Axone 平台中)。
  • 基于 JSON-RPC 协议通信: 服务器完全遵循 MCP 协议，使用 JSON-RPC 格式与客户端进行通信，处理客户端的请求并返回响应。
  • 支持 Stdio 和 SSE 传输协议: 服务器支持通过标准输入输出 (Stdio) 和服务器发送事件 (SSE) 两种传输协议与客户端通信，适应不同的应用场景，例如 Stdio 适用于本地集成和命令行工具，SSE 适用于浏览器环境。
  • 会话管理和能力声明: MCP 服务器负责管理客户端会话，并在会话建立时声明自身的能力，告知客户端所支持的功能和工具。
  • 授权层: Axone MCP 服务器集成了授权层，确保所有访问请求都经过授权验证，符合 Axone 链上定义的去中心化治理规则，增强了安全性。

安装步骤

  1. 安装 Go 环境: 确保你的系统已安装 Golang。
  2. 安装 Axone MCP 服务器: 使用 'go install' 命令即可安装： 
    go install github.com/axone-protocol/axone-mcp@latest
    安装成功后，'axone-mcp' 可执行文件将会被安装到 '$GOPATH/bin' 目录（或 '$HOME/go/bin'，取决于你的 Go 环境配置）。请确保该目录已添加到你的系统 'PATH' 环境变量中。

服务器配置 (MCP 客户端配置)

对于 MCP 客户端 (例如 Claude Desktop)，你需要配置 MCP 服务器的启动信息，以便客户端能够连接到 Axone MCP 服务器。配置信息通常以 JSON 格式提供。

以下是针对 Claude Desktop 的 'claude_desktop_config.json' 示例配置，展示了如何配置 Axone MCP 服务器作为一个名为 "filesystem" 的服务器：

{
  "mcpServers": {
    "filesystem": {
      "command": "axone-mcp",
      "args": [
        "serve",
        "stdio"
      ]
    }
  }
}

配置参数说明:

  • '"filesystem"': 服务器名称 (server name)，客户端用于标识和引用此服务器的名称，可以自定义。
  • '"command": "axone-mcp"': 启动命令 (command)，指定启动 Axone MCP 服务器的可执行文件名称。假设 'axone-mcp' 已正确安装并添加到系统 'PATH'。
  • '"args": ["serve", "stdio"]': 命令参数 (args)，传递给 'axone-mcp' 命令的参数。
    • '"serve"': 指定 'axone-mcp' 执行 "serve" 子命令，即启动服务器模式。
    • '"stdio"': 指定使用 "stdio" 传输协议，通过标准输入输出与客户端通信。

其他传输协议配置 (SSE):

如果希望使用 SSE 传输协议，可以将 'args' 修改为：

{
  "mcpServers": {
    "sse_server": {  // 服务器名称可以自定义，例如 "sse_server"
      "command": "axone-mcp",
      "args": [
        "serve",
        "sse",
        "--listen-addr",
        "localhost:8080" // 可选: 指定监听地址和端口，默认为 127.0.0.1:8081
      ]
    }
  }
}

SSE 传输协议参数说明:

  • '"sse"': 指定使用 "sse" 传输协议。
  • '"--listen-addr", "localhost:8080"': 可选参数，用于指定服务器监听的地址和端口。如果省略，则默认监听 '127.0.0.1:8081'。

基本使用方法

  1. 启动服务器:

    • Stdio 传输: 在终端中运行 'axone-mcp serve stdio' 命令即可启动基于 Stdio 协议的服务器。
    • SSE 传输: 在终端中运行 'axone-mcp serve sse --listen-addr localhost:8080' (或自定义地址) 命令启动基于 SSE 协议的服务器。

  2. 配置 MCP 客户端: 根据你使用的 MCP 客户端 (例如 Claude Desktop)，按照其文档说明配置 MCP 服务器连接信息，通常需要提供服务器名称、启动命令和参数。参考上面的 服务器配置 (MCP 客户端配置) 部分。

  3. 客户端与服务器交互: 客户端启动后，会根据配置信息连接到 Axone MCP 服务器，并按照 MCP 协议进行通信，例如发送 JSON-RPC 请求来调用工具、访问资源或获取 Prompt 模板。具体交互方式取决于 MCP 客户端的功能和使用方法。

注意: 示例代码中仅包含了一个简单的 'hello_world' 工具。实际的 Axone MCP 服务器可能集成更丰富的功能和工具，具体取决于 Axone 平台的实现。

信息

分类

AI与计算

访问项目