Por MCP Server

通过MCP服务器

MCP服务器，允许LLM查询英国童子军政策、组织和规则（POR），包括苏格兰的变体和附件。首次使用时，它会下载官方POR PDF并将提取的文本缓存在内存中，然后公开一个MCP工具： search_por.

使用Claude代码安装

直接从GitHub添加服务器——无需手动克隆：

claude mcp add por -- uvx --from git+https://github.com/Moncky/por-mcp-server por-mcp-server

这将获取包并将其注册为名为的MCP服务器 por.通过以下方式进行验证：

claude mcp list

要固定特定的发布或提交，请附加 @:

claude mcp add por -- uvx --from "git+https://github.com/Moncky/por-mcp-server@v0.1.0" por-mcp-server

使用Claude Desktop安装

Claude Desktop通过本地Docker容器运行服务器。

1.克隆仓库并构建镜像：

git clone https://github.com/Moncky/por-mcp-server.git
cd por-mcp-server
docker build -t por-mcp-server:latest .

2.打开您的Claude Desktop配置文件：

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• 视窗: %APPDATA%\Claude\claude_desktop_config.json

3.添加以下条目 （创建 mcpServers 对象（如果不存在）：

{
  "mcpServers": {
    "por": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "por-mcp-server:latest"
      ]
    }
  }
}

4.重新启动克劳德桌面。 你应该看到 por 列在已连接的MCP服务器下。

获取更改后 git pull，用相同的方法重建图像 docker build 命令并重新启动Claude Desktop。

构建并运行（本地克隆/uv）

cd por-mcp-server
uv run por_server.py

服务器通过stdio与MCP通信，所以你通常会这样做 不 直接运行它。要在克隆后将其与Claude Code连接起来：

claude mcp add por -- uv run --directory /absolute/path/to/por-mcp-server por_server.py

使用MCP检查员进行测试

npx @modelcontextprotocol/inspector uv run por_server.py

工具： search_por

• 名称: search_por
• 描述：在英国童子军POR（包括附件）上进行免费文本搜索。
• 输入架构:

- query （字符串，必填）-搜索短语。

• 行为:

- 第一次通话时，下载官方POR PDF（约7MB）并从所有429页（约1.5秒）中提取文本。 - 对缓存文本执行不区分大小写的子字符串搜索。 - 返回最多10个匹配的页面，其中包含代码片段和PDF页码，以便LLM可以引用和推理POR。

查询示例

一旦服务器连接到MCP客户端，您就可以问LLM问题，例如：

• *“与童子军一起过夜露营的规则是什么？”* --法学硕士将致电 search_por 使用类似的查询 "camping" 或 "nights away" 并引用相关POR章节。
• *“海狸童子军可以接受5岁的孩子吗？”* --触发对与年龄相关的规则和会员要求的搜索。
• *“成年志愿者需要接受哪些安全防护培训？”* --搜索DBS、安全和培训政策。
• *“苏格兰对水上活动有具体规定吗？”* --发现苏格兰POR变化和水活动附件。
• *“徒步旅行的最低成人与年轻人比例是多少？”* --搜索比例、冒险活动和监督规则。

LLM负责选择正确的搜索词，解释结果，并用页面引用将POR引用给您——您只需用简单的英语提问。

许可证

麻省理工学院——见 许可证.