Explorium API MCP 服务器

此 MCP 服务器用于与 Explorium API 交互。

注意： 这是用于开发 MCP 服务器的 README。 有关使用说明，请参阅 README-pypi.md。

设置

克隆存储库：

git clone https://github.com/explorium-ai/mcp-explorium.git
cd mcp-explorium

安装 uv 并激活虚拟环境：

pip install uv
uv sync --group dev

本地运行

在本地开发时，使用 local_dev_server.py 将 MCP 服务器暴露给本地客户端。

您可以使用 MCP Inspector 进行测试：

mcp dev local_dev_server.py

如果尚未配置，请在存储库的根目录中创建一个包含 EXPLORIUM_API_KEY 环境变量的 .env 文件。

与 Claude Desktop 一起使用

按照官方指南安装 Claude Desktop 并将其设置为使用 MCP 服务器：

https://modelcontextprotocol.io/quickstart/user

然后，将此条目添加到您的 claude_desktop_config.json 文件中：

{
  "mcpServers": {
    "Explorium": {
      "command": "<UV_INSTALL_PATH>",
      "args": [
        "run",
        "--directory",
        "<REPOSITORY_PATH>",
        "mcp",
        "run",
        "local_dev_server.py"
      ],
      "env": {
        "EXPLORIUM_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

请务必将所有 <PLACEHOLDERS> 替换为实际值。

运行 which uv 以获取您的 uv 安装路径。

与 Cursor 一起使用

Cursor 具有 对 MCP 服务器的内置支持。

要将其配置为使用 Explorium MCP 服务器，请转到 Cursor > Settings > Cursor Settings > MCP 并添加一个带有以下命令的 "Explorium" 条目：

uv run --directory repo_path mcp run local_dev_server.py

确保将 repo_path 替换为存储库的实际路径。

您可以在 Cursor 设置中启用 "Yolo mode"，以便在 Cursor > Settings > Cursor Settings > Features > Chat > Enable Yolo mode 下使用工具而无需确认。

注意： 如果未安装开发依赖项，或者未激活虚拟环境，则本地使用将不起作用。

构建和部署

要构建 MCP 服务器，请在 pyproject.toml 中增加版本号，然后运行：

uv build

这将在 dist 目录中创建一个构建的包。

然后，您可以使用以下命令将软件包部署到 PyPI：

twine upload dist/*