英国科学博物馆集团 API 的模型上下文协议服务器

本项目是一个 Python MCP (https://modelcontextprotocol.io/introduction) 服务器，允许你的 LLM 从英国科学博物馆集团获取数据。信息可在 https://github.com/TheScienceMuseum/collectionsonline/wiki/Collections-Online-API#get-search 获取。

目前它支持 MacOS 和 Windows 上的 Claude Desktop。

与 Claude Desktop 集成

你只需要安装 UV，一个 Python 包/项目管理器，然后更改你的 Claude Desktop 设置以添加此 MCP。

对于 MacOS：

brew install uv

对于 Windows：

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

或者使用 winget：

winget install --id=astral-sh.uv  -e

其他安装选项可在 https://docs.astral.sh/uv/getting-started/installation 获取。

要配置 Claude Desktop，请转到 Claude Desktop 的设置 -> 开发者，编辑配置。

这将在以下位置创建一个配置文件：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

打开此文件并将其更改为：

{
  "mcpServers": {
    "scienceMuseum": {
      "command": "uvx",
      "args": [
        "science-museum-mcp"
      ]
    }
  }
}

打开 Claude Desktop 现在应该启动 MCP 服务器，并且可以查询 Claude。 例如：

<img width="748" alt="Screenshot 2025-04-15 at 19 43 05" src="https://github.com/user-attachments/assets/6690b802-24c3-40f0-85b2-d4a2b6cc5460" />

Anthropic 自己的此步骤说明在此处 - https://modelcontextprotocol.info/docs/quickstart/user/。

开发

本节适用于任何想要为代码库做出贡献的人。

设置和安装依赖项

克隆存储库。

该项目配置为使用 uv (安装链接: https://docs.astral.sh/uv/#installation) 进行依赖管理和构建。 它使用 npx (安装链接: https://www.npmjs.com/package/npx) 运行 MCP 检查器。

使用以下命令创建虚拟环境：

uv venv

并使用以下命令安装依赖项：

uv pip install -r pyproject.toml

使用以下命令运行检查器：

./inspector.sh

检查器应输出用于访问其 UI 的 localhost URL。

运行单元测试

source .venv/bin/activate
pytest

发布

这目前是一个我可以手动完成的过程。 如果该项目从现在开始有任何开发，这将更改为 Github 操作。