使用说明

项目简介

OpenDataMCP (Open Data Model Context Protocol) 旨在简化大型语言模型（LLMs）访问和利用开放数据的过程。它基于 Model Context Protocol (MCP) 构建，允许开发者轻松创建和部署 MCP 服务器，将各种公共数据集以标准化的方式提供给 LLM 应用。通过 OpenDataMCP，用户可以快速为 LLM 扩展数据访问能力，无需复杂的 API 集成和数据处理。

主要功能点

开放数据访问: 预置了如瑞士联邦铁路（SBB）等公共数据集的MCP服务器，即装即用，方便LLM直接访问。
工具 (Tools): 将数据集功能封装为易于LLM调用的工具，例如查询列车时刻表、获取交通信息等。
可扩展性: 采用模块化设计，易于添加新的数据源和工具，用户可以贡献和发布自己的开放数据 MCP 服务。
CLI 工具: 提供命令行工具 'odmcp'，用于管理和配置 MCP 服务器，包括列出可用数据源、查看数据源信息、安装和移除 MCP 服务器等。
与 Claude Desktop 集成: 特别优化了与 Claude Desktop 应用的集成，通过简单的命令即可将 MCP 服务器配置到 Claude 中使用。

安装步骤

安装 UV 包管理器

OpenDataMCP 推荐使用 'uv' 包管理器，它比 'pip' 更快。

macOS:
```
brew install uv
```

Windows (PowerShell):

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

Linux/WSL:

curl -LsSf https://astral.sh/uv/install.sh | sh

克隆并设置仓库

git clone https://github.com/OpenDataMCP/OpenDataMCP.git
cd OpenDataMCP
uv venv
source .venv/bin/activate  # Unix/macOS
# 或
.venv\Scripts\activate     # Windows
uv sync

安装指定数据源的依赖

例如，要使用瑞士联邦铁路 (SBB) 的数据源，需要安装 'odmcp[ch_sbb]' 包。
```
uv pip install odmcp[ch_sbb]
```
如果要安装所有数据源的依赖，可以使用 'odmcp[all]'。
```
uv pip install odmcp[all]
```

服务器配置

OpenDataMCP 的 MCP 服务器主要通过命令行工具 'odmcp' 启动。对于 MCP 客户端（如 Claude Desktop），需要配置 MCP 服务器的启动命令和参数。以下是针对 Claude Desktop 应用的 MCP 服务器配置示例 (JSON 格式)：

{
  "mcpServers": {
    "ch_sbb": { //  服务器名称，这里使用数据提供商的标识符 "ch_sbb"
      "command": "uvx", //  启动服务器的命令，uvx 是使用 uv 运行命令的工具
      "args": [      //  传递给命令的参数列表
        "odmcp",    //  执行 odmcp 包
        "run",      //  odmcp 的子命令，用于运行 MCP 服务器
        "ch_sbb"    //  指定要运行的数据提供商 (瑞士联邦铁路)
      ]
    }
  }
}

基本使用方法

列出可用的数据源 (providers)
```
uvx odmcp list
```
查看特定数据源的信息
```
uvx odmcp info ch_sbb
```
将 'ch_sbb' 替换为您感兴趣的数据源名称。
安装 MCP 服务器到 Claude Desktop (仅限 macOS 和 Windows)
```
uvx odmcp setup ch_sbb
```
此命令会自动配置 Claude Desktop 应用，使其能够连接到 'ch_sbb' 数据源的 MCP 服务器。安装后，重启 Claude Desktop 应用，即可在聊天界面右下角看到锤子图标，点击即可使用 MCP 工具。
移除 MCP 服务器配置 (仅限 macOS 和 Windows)
```
uvx odmcp remove ch_sbb
```
移除指定数据源的 MCP 服务器配置。同样需要重启 Claude Desktop 应用生效。
手动运行 MCP 服务器
```
uvx odmcp run ch_sbb
```
此命令会直接运行 'ch_sbb' 数据源的 MCP 服务器，用于测试和开发。

贡献数据源

如果您希望贡献新的开放数据源，可以参考仓库中的模板文件创建新的 provider 模块，并按照 Publishing Instructions 提交您的贡献。

关键词

使用说明

信息