cangjie-mcp

# Cangjie MCP Server [](https://github.com/Zxilly/cangjie-mcp/actions/workflows/ci.yml) [](https://pypi.org/project/cangjie-mcp/) [](https://pypi.org/project/cangjie-mcp/) [](https://github.com/Zxilly/cangjie-mcp/releases) [](LICENSE) 仓颉编程语言的 MCP (Model Context Protocol) 服务器，提供文档搜索和代码智能功能。 ## 功能 - **文档搜索**: 基于向量检索的仓颉语言文档搜索 - **代码智能**: 基于 LSP 的跳转定义、查找引用、悬停信息等功能 - **可选远程文档服务**: 支持连接远程文档/索引服务，减少本地资源占用，适合开箱即用或团队共享 ## 安装 你可以根据偏好的包管理器，选择通过 PyPI (Python) 或 npm (Node.js) 进行安装。 ### 通过 PyPI 安装 (Python) ```bash pip install cangjie-mcp ``` #### 安装并指定 Rust feature 当平台没有预编译 wheel，或你希望按需启用 GPU/NPU 等加速后端时，可强制从 sdist 构建并传入 maturin 构建参数： ```bash pip install --no-binary cangjie-mcp cangjie-mcp \ --config-settings=build-args="--features local" ``` 可用 feature（传给 `cangjie-mcp-cli`）： - `local`：本地向量化（CPU；默认构建的二进制已启用） - `legacy`：本地向量化改用 `ort-tract` 后端（适配旧 glibc 构建） - `local-cuda` / `local-cudnn`：启用 CUDA/CUDNN 后端 - `local-metal`：启用 Apple Metal 后端 - `local-mkl` / `local-accelerate`：启用 MKL / Accelerate 后端 ### 通过 npm 安装 (Node.js) ```bash npm install -g cangjie-mcp ``` npm 默认优先使用预编译二进制；当当前平台没有匹配包，或 Linux 的 glibc 低于 `2.28` 时，会自动回退到本地源码构建。你也可以显式强制源码构建： ```bash CANGJIE_MCP_FORCE_BUILD=1 npm install -g cangjie-mcp ``` ## 架构 cangjie-mcp 支持两种运行模式： ### 本地模式（默认） MCP 服务器在本地加载检索索引（BM25 + 向量索引），直接处理查询。 ```bash cangjie-mcp # 或 uvx cangjie-mcp ``` ### 远程服务模式（可选） 如果你不想在本机下载/加载向量模型与索引（或希望多人/多台机器共享同一套索引），可以把检索能力独立部署为 `cangjie-mcp-server`，同时对外提供： - **HTTP 查询 API**，供本地 `cangjie-mcp --server-url` 连接（LSP 工具仍在本地可用） - **Remote MCP 端点**，MCP 客户端无需本地运行 `cangjie-mcp` 即可直接连接 - Streamable HTTP（默认 `/mcp`）— [MCP 规范推荐的现代传输方式](https://modelcontex…