Axiom MCP 服务器

关键词

Model Context ProtocolresourcestoolspromptsJSON-RPC

使用说明（Markdown格式）：

  • 项目简介
    • Axiom 的 MCP 服务器端实现，采用 Node.js/TypeScript，核心职责是通过 MCP 协议向客户端提供可访问的资源、工具和提示模板，并渲染/返回相应的内容。
    • 服务端设计了资源、提示、工具三大能力，以及会话管理、能力声明和多传输协议支持的框架。
    • 提供开发模式（从本地插件目录热加载技能/代理）和生产模式（加载打包 bundle.json 的离线数据），并通过 STDIO 传输与 MCP 客户端对话（也可扩展为其他传输通道）。
  • 主要功能点
    • 资源(Resource)：列出并读取技能内容作为资源，支持按 URI 获取完整文本。
    • 工具(Tools) - 动态工具集：实现 axiom_get_catalog、axiom_search_skills、axiom_read_skill、axiom_get_agent 等工具，提供技能目录、全文检索、技能内容及代理指令等能力。
    • 提示(Prompts) 与命令/代理集成：将命令（Prompts）与代理（Agents）集合化，供 LLM 调用和查询。
    • 加载与数据源：开发模式从 Claude Code 插件目录热加载，生产模式从 bundle.json 读取；同时支持 Apple 文档（通过 Xcode 加载的 Apple 官方文档）。
    • 本地化与测试覆盖：针对资源、工具、索引、目录结构等提供了测试用例与行为断言，提升稳定性。
  • 安装步骤
    • 前提条件：Node.js 环境、TypeScript 编译/构建工具链，以及对 MCP 客户端的集成需求（描述性接口与请求路径由 MCP 生态标准定义）。
    • 步骤概要
      1. 将仓库完整克隆到本地。
      2. 安装依赖：进入 mcp-server 目录，运行依赖安装命令。
      3. 构建服务：执行构建步骤得到可运行入口（通常是编译后的 dist/index.js / 可执行入口）。
      4. 启动服务：以产出入口启动服务，默认通过标准输入/输出（stdio）与 MCP 客户端通信。
      5. 可选：在开发模式下提供 AXIOM_DEV_PATH 指定的插件路径，服务将热加载插件中的技能、命令与代理。
  • 服务器配置（MCP 客户端配置示例，JSON 格式，包含 server name、command、args 等） { "server_name": "axiom-mcp", "command": "node", "args": ["path/to/axiom-mcp-server/dist/index.js"], "transport": "stdio", "description": "Axiom MCP Server - 运行在本地环境，通过 STDIO 与 MCP 客户端通讯" } 说明：
    • server_name 表示 MCP 服务端的识别名称，与服务本身的名称保持一致，便于客户端在多服务器场景中区分。
    • command 与 args 指定启动服务器的命令及参数，客户端无需了解实现细节，仅需提供正确的启动方式。
    • transport 指定传输通道，这里为 stdio，表示通过标准输入输出与客户端交互（MCP 规范也支持其他传输，当前实现以 stdio 为主）。
  • 基本使用方法
    1. 启动服务器进程，确保服务器输出日志正常，能够响应请求。
    2. MCP 客户端通过 JSON-RPC 发送请求，例如读取资源、执行工具调用、获取提示等。
    3. 服务器将按请求类型路由到相应处理器（资源、工具、提示）并返回 JSON-RPC 响应。
    4. 客户端根据响应内容进行后续处理（渲染、进一步查询、调用其他工具等）。
    5. 在开发阶段若有文件变更，开发模式会通过文件监听自动通知客户端工具列表变更以便缓存更新。

服务器信息

访问项目