内容
# 总会宪法 MCP
韩国基督教长老会总会宪法资料查询的本地 MCP 服务器项目。该服务器仅支持读取，不使用 HTTP 服务器、远程调用、数据库、LLM 和嵌入式技术。
[](LICENSE)
[](https://www.python.org/)
[](https://modelcontextprotocol.io)
## 连接 AI
前提条件：[uv](https://docs.astral.sh/uv/) 和 Python 3.11 以上。
### Claude Code 插件（最简单）
在 Claude Code 中，只需两行命令即可完成。直接从 GitHub 仓库安装，无需单独设置 vault 路径。
```console
/plugin marketplace add addmirer144/PROK-constitution-mcp
/plugin install prok-constitution
```
安装后重启 Claude Code，即可使用 `search_constitution`、`get_constitution`、`get_related` 和 `verify_citation` 工具。
### 其他 MCP 客户端（Claude Desktop、Cursor 等）
在 PyPI 发布后，可以使用一行命令 `uvx` 运行，无需克隆仓库。vault 已包含在包中，无需指定 `--vault`。
```json
{
"mcpServers": {
"constitution": {
"command": "uvx",
"args": ["constitution-mcp"],
"env": { "PYTHONDONTWRITEBYTECODE": "1" }
}
}
}
```
或者克隆仓库后，使用以下 JSON 配置。请将路径替换为克隆仓库的绝对路径。
```json
{
"mcpServers": {
"constitution": {
"command": "uv",
"args": [
"run",
"--directory",
"/absolute/path/to/PROK-constitution-mcp/mcp_server",
"constitution-mcp",
"--vault",
"/absolute/path/to/PROK-constitution-mcp/vault"
],
"env": { "PYTHONDONTWRITEBYTECODE": "1" }
}
}
}
```
详细工具说明和本地运行方法请参考 [mcp_server/README.md](mcp_server/README.md)。
## 配置
- `mcp_server/`：Python MCP 服务器、CLI、测试和包配置
- `vault/`：生成的宪法 Markdown vault
- `constitution_converter/`、`scripts/`：vault 再生工具
MCP 服务器使用方法请参考 [mcp_server/README.md](mcp_server/README.md)。
## 发布标准
发布候选版本必须通过以下命令：
```console
PYTHONDONTWRITEBYTECODE=1 uv run --directory mcp_server pytest -q
uv run --directory mcp_server ruff check src tests
uv run --directory mcp_server basedpyright
uv lock --directory mcp_server --check
```
提交到 Git 时，不得包含 `.venv`、`.obsidian`、`.omo`、`.DS_Store`、缓存和构建产物。
## 数据和许可证
代码以 MIT 许可证发布。`vault/` 中的原始派生数据与代码许可证分开，在公开重新分发前，必须检查原始来源和重新分发权限。详细信息请参考 [DATA_POLICY.md](DATA_POLICY.md)。
## 非官方指南
本项目的响应是辅助原始文本搜索的非官方本地查询结果，不代替总会或教团的官方解释、法律咨询或司法裁决。
