Mini AI 1C MCP 服务器集合
使用说明（简要要点，非冗长描述）：
- 项目简介
- 本仓库实现了一组基于 MCP 的 1C 相关服务器，包括元数据、帮助文档、Naparnik、以及搜索等服务，以及一个用于搜索的 MCP 服务实现。这些服务器通过 MCP 协议向客户端提供资源读取、工具调用、以及提示模板等上下文能力，辅助 LLM 更好地理解和操作 1C 开发环境中的代码和结构。
- 主要功能点
- MCP 服务器核心能力：能够处理 MCP 请求（读取资源、列出工具、获取提示等），并返回标准的 JSON-RPC 响应。
- 资源、工具、Prompts 的注册与渲染：内置服务器注册常用的资源、工具与提示模板，支持对外部工具的调用与数据访问。
- 传输模式支持：内置的服务器实现支持 stdio、HTTP 传输，以及内部对象（如 BSL LS）的集成。部分实现通过嵌入式资源/代理实现“真便携”部署。
- 1C 相关的具体服务：
- 1C:Справка（帮助文档）服务（基于 HBK 解析对 1C 帮助内容进行索引与查询）。
- 1C:Метаданные（元数据）服务（构建对象及其字段/属性结构的元数据图谱）。
- 1C:Напарник（Naparnik）服务（对 1C:AI/云端 API 的访问与诊断）。
- 1C:Поиск（搜索）服务（对代码的快速搜索、符号定位、上下文提取等）。
- 自带的本地工具库：MCP 客户端实现、服务器状态查询、日志导出、以及对 BSL/Prompts 等的支持。
- 安装步骤
- 准备工作：确保系统具备运行 MCP 客户端所需的运行环境（Node.js、Rust、可能的 JRE/Java 运行时用于 BSL LS、以及必要的依赖）。
- 构建与启动：
- 使用仓库提供的构建与运行方式，将 MCP 服务器打包到应用中，并在启动时加载嵌入的 MCP 服务器（1C 相关服务器）以及 BSL LS（若使用）。
- 通过配置文件（JSON）为 MCP 客户端提供服务器列表，包含服务器名称、启动命令、参数等信息（见下方“服务器配置”示例）。
- 运行后，通过客户端配置的 MCP 服务器与之建立连接，客户端即可调用服务器提供的工具、资源与 Prompts。
- 服务器配置（MCP 客户端所需的启动信息，JSON 表达，方便理解示例）
说明：以下为示例配置，展示需要的字段及含义，实际部署以仓库内实现所需字段为准。配置用于 MCP 客户端的连接，包含服务器名称、启动命令与参数等信息，用于启动和对接 MCP 服务器。
{
"servers": [
{
"id": "builtin-1c-metadata",
"name": "1C:Метаданные",
"enabled": true,
"transport": "stdio",
"command": "node",
"args": ["mcp-servers/1c-metadata.cjs"],
"env": null
},
{
"id": "builtin-1c-naparnik",
"name": "1C:Напарник",
"enabled": true,
"transport": "stdio",
"command": "node",
"args": ["mcp-servers/1c-naparnik.cjs"],
"env": null
},
{
"id": "builtin-1c-help",
"name": "1C:Справка",
"enabled": true,
"transport": "stdio",
"command": "node",
"args": ["mcp-servers/1c-help.cjs"],
"env": null
},
{
"id": "builtin-1c-search",
"name": "1C:Поиск",
"enabled": true,
"transport": "stdio",
"command": "mcp-1c-search",
"args": [],
"env": null
},
{
"id": "bsl-ls",
"name": "BSL Language Server",
"enabled": true,
"transport": "internal",
"url": null
}
]
}
- 说明
- builtin-1c-metadata、builtin-1c-naparnik、builtin-1c-help 为嵌入式 Node 服务，使用 node 启动并加载嵌入的 cjs 资源。
- builtin-1c-search 为 Rust 实现的独立 MCP 服务器（可作为外部服务或本地执行的二进制）。
- bsl-ls 为内置的 BSL 语言服务器（内部传输，作为一项虚拟服务器出现在客户端列表中）。
- 说明
- 基本使用方法
- 将上述配置放入 MCP 客户端配置中，启动 MCP 客户端应用后，客户端即可向这些服务器发起资源/工具/Prompts 相关请求，获取统一的 JSON-RPC 响应。
- 通过 MCP 客户端能力查看服务器状态、日志、以及可用工具；必要时可对服务器进行重启/重新加载。
- 运行与扩展
- 该实现不仅提供了 1C 相关的服务器端能力，还通过嵌入资源的方式实现了“真端携带化部署”，便于在不依赖外部环境的场景下运行 MCP 服务器。
- 若需要添加新的 MCP 服务，只需实现相应的服务器（如 1C:Справка、1C:Метаданные 等），并在客户端的服务器配置中注册即可。