POR查询服务

一个允许LLM查询英国童子军政策、组织和规则(POR)的服务,包括苏格兰变体和附件。首次使用时下载官方POR PDF并将提取的文本缓存在内存中,提供一个名为`search_por`的MCP工具。

  • by Moncky
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 Moncky/por-mcp-server

使用说明

通过MCP服务器

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

先决条件: 码头工人 克劳德桌面公司; uv Claude Code和当地发展。

使用Claude代码安装

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

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

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

claude mcp list

要固定特定的发布或提交,请附加 @<tag-or-sha>:

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引用给您——您只需用简单的英语提问。

许可证

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