概述

它是什么

Axon MCP Server 是一个 Model Context Protocol 服务器，为 AI 助手提供对 Axon 代码库的专家级访问权限。它索引 Axon 源文件和 HTML 文档，通过 MCP 暴露搜索和代码生成工具，并可以对实时 SkySpark 实例执行查询。

Axon 是 SkySpark 的领域特定语言，用于楼宇自动化、HVAC 控制和能源管理。MCP 服务器将一个 Axon 代码文件夹转变为结构化知识库，任何 MCP 兼容客户端——Claude Desktop、Cursor、MCP CLI——都可以查询。

你可以用它做什么

• 跨 Axon 代码和文档搜索 — 由 FlexSearch 驱动的全文搜索，支持相关性评分、操作符级查询和正则表达式模式。
• 生成新的 Axon 代码 — 为常见 HVAC、能源、故障和数据工作流提供的 33 个精选 YAML 模板。生成的代码在返回前经过语义验证。
• 针对实时 SkySpark 实例执行代码 — 运行 Haystack 查询、评估 Axon 表达式和提交具有自动版本控制的函数。
• 分析调用图 — 查找调用者和被调用者、检测循环依赖、识别调用次数最多或最复杂的函数。
• 使用向量嵌入进行语义搜索 — 自然语言查询返回代码含义匹配的结果，而不仅仅是关键字匹配。

它如何组合在一起

┌──────────────────┐     MCP       ┌──────────────────────┐      HTTP    ┌────────────┐
│ AI 客户端        │ ─────────────▶│ Axon MCP Server      │ ────────────▶│ SkySpark   │
│ (Claude, Cursor) │               │  • 搜索索引          │              │ (Haystack) │
│                  │               │  • 代码生成器        │              └────────────┘
│                  │ ◀─────────────│  • 图形分析器        │
└──────────────────┘    结果       │  • OAuth 2.1         │
                                    └──────────────────────┘
                                              │
                                              ▼
                                       .axon / .trio 文件
                                       HTML 文档

连接通过 stdio（本地 AI 客户端将服务器作为子进程生成）或 http（OAuth 后的远程客户端）运行。/admin 处的仪表板为会话和用户管理提供 Web UI。

关键功能

• 快速搜索 — 跨数千个 HTML 文件的全文搜索耗时约 50 毫秒；初始索引需要 30–60 秒，并被缓存。
• OAuth 2.1 with PKCE — 多用户身份验证、作用域令牌（mcp:read、mcp:write、mcp:admin）。
• 函数版本控制 — 自动保留通过服务器提交的每个函数的最后 4 个修订版本。
• 自动发现 — 配置一个 SkySpark 实例；服务器自动枚举项目并同步它们的函数。
• 本地 SQLite 持久化 — 用户存储、备份清单和图形指标都通过 Prisma 驻留在单个文件中。

项目状态

该服务器处于活跃开发中，在搜索、执行和代码生成工作流方面被认为是稳定的。许可证：ISC。欢迎在 GitHub 上提出问题和贡献。