Opendata MCP

元数据mcp

一个MCP服务器，透明地将用户请求路由到66个开放数据源。

meta-data-mcp 是一个MCP服务器，不是很多。引擎盖下捆着66 *插件*，每个包装一个不同的开放数据API。插件是一个实现细节；从法学硕士的角度来看，有一个服务器、一组工具和一个地方可以问“我在哪里可以找到关于X的数据？”

安装一台服务器。您可以通过内置的路由工具获取所有可发现的数据。

为什么是“元”？

找到开放数据并不是最难的部分——有大量的开放数据可供使用。最困难的部分是找到正确的数据集 *当你需要它的时候*. meta-data-mcp 使其自动：

• LLM电话 opendata-find-providers （“汇率”、“法院裁决”、“里斯本附近的地震”），服务器将查询路由到每个捆绑插件的内部注册表。
• 然后LLM直接调用匹配工具。中间没有设置步骤，没有单独的服务器，没有每个提供商的安装仪式。

这个项目是从 开放数据mcp 一旦目录通过了几十个插件，它就围绕单服务器的想法进行了重塑。

安装

你需要 uv （Python包管理器）。

# macOS — install uv via Homebrew so MCP clients can find it
brew install uv

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

# Windows (PowerShell)
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

然后在计算机上安装的每个MCP客户端上注册服务器：

uv run meta-data-mcp setup

该命令自动检测您安装并添加了哪些MCP客户端 一 meta-data-mcp 进入下 mcpServers 在每一个。支持的客户端：

每个现有配置都备份到 .bak 在写作之前。重启受影响的客户端，你会看到一个新的服务器，上面有发现工具+每个插件的工具。

检查机器上检测到/配置的内容：

uv run meta-data-mcp clients

针对单个客户端（或写入每个受支持的客户端，而不管是否检测到）：

uv run meta-data-mcp setup --client claude-code
uv run meta-data-mcp setup --client all

如果你想在不接触任何配置文件的情况下看到JSON代码段（例如粘贴到我们尚不支持的客户端）：

uv run meta-data-mcp setup --print-json

当 META_DATA_MCP_AUTH_TOKEN 设置， --print-json 还将SSE客户端代码段（带有真实令牌）显示给stderr，以便您可以连接远程客户端。

托管 meta-data-mcp 作为远程SSE服务器

要使用承载令牌身份验证在自己的域后部署，请参阅 docs/hosting.md。它涵盖了 systemdCaddy/nnginx TLS终止、令牌轮换和威胁模型。

命令行界面

有一个服务器，因此CLI不接受“提供者”参数。每个命令都在一个 meta-data-mcp 服务器。

这 list 命令的存在是为了提高捆绑内容的透明度-- 插件不能单独安装、运行或寻址。它们在服务器启动时自动加载。

服务器工具（LLM称之为）

曾经 meta-data-mcp 当LLM正在运行时，它可以访问两层工具——你不需要向用户提及任何一层：

1. 元工具 --下面八个服务器级工具。它们使路由透明：LLM使用它们来查找（或创建）正确的插件，而无需告诉它调用哪个工具。
2. 插件工具 --来自66个捆绑插件的约330个工具。它们在启动时合并到同一个命名空间中。LLM在咨询元工具后选择了一个。

元工具

自主发现流程

此服务器被称为“meta”的原因是，它代表用户路由数据请求，包括 *创建* 当一条路线还不存在时。全流程：

1. 用户要求提供数据，例如“显示最新发布的CVE。”
2. LLM电话 opendata-find-providers 与查询(cve, vulnerability, …).
3. 如果注册表有匹配项：LLM选择匹配插件的工具并回答——完成。
4. 如果注册表没有匹配项：响应包括 no_match: true 和一个 next_step 解释自主创建路径的字段。法学硕士：

1. 告诉用户它将为该数据源添加覆盖范围。 1. Web搜索公开请求数据的开放API（例如NVD或CIRCL CVE API）。 1. 呼叫 opendata-draft-spec 带有API的id、基本URL和结构化工具定义。服务器验证输入（id大小写、路径占位符一致性、参数类型）并返回一个YAML字符串。 1. 将该YAML传递给 opendata-create-plugin服务器实现插件模块+测试、导入模块、注册 ProviderEntry 并将新工具合并到正在运行的服务器的工具列表中。 1. 调用新可用的工具来回答用户的原始问题。

1. 用户得到答案 --并且该插件在会话的剩余时间内仍然可用。

物化插件存在于磁盘上(meta_data_mcp/providers/{id}.py + tests/providers/test_{id}.py)；贡献者可以清理它，将其添加到 meta_data_mcp/registry.py 作为静态条目，打开一个PR，使其成为每个已发货安装的一部分。

插件工具

每个捆绑的插件都在一个服务器下贡献自己的工具。它们的名称是唯一的烤肉串案例标识符，通常使用特定于提供商的前缀（例如。 usgs-eq-feed-significant-week, frankfurter-latest, wikipedia-fetch-summary).LLM通过以下方式发现它们 opendata-find-providers 和 opendata-describe-provider你不需要记住它们。

捆绑插件（66）

这是一台服务器内部的内容。你不需要单独安装这些——它们都是附带的。

政府/公民

统计学/经济学

金融/市场

健康与生命科学

地球科学/天气/环境

生物多样性/空间/物理学

地理/地图/知识

过境/航空

学术文献

文化/书籍

网络/互联网

法律

可选环境变量

一些捆绑插件接受可选的API密钥以获得更高的速率限制。在shell或Claude Desktop服务器配置中设置这些 env 块：

运输

run 默认为 上海证券交易所 （HTTP，端口8000），因此您可以从MCP检查器或远程客户端进行连接。对于克劳德桌面（哪 setup 命令目标），生成的进程使用 标准:

uv run meta-data-mcp run                                  # SSE on 127.0.0.1:8000
uv run meta-data-mcp run --transport stdio                # stdio
uv run meta-data-mcp run --host 0.0.0.0 --port 3001       # SSE bound to all interfaces

路线图

• v1.2--分层发现： opendata-list-subcategories 和 opendata-browse-providers 用户可以浏览域的工具→ 子类别→ 当他们不知道自己需要什么时。
• v1.3--代理驱动生成： 将路由引擎的no-match路径挂接到一个代理中，该代理找到一个开放的API，生成一个提供程序模块，并自动注册它——在没有用户干预的情况下关闭覆盖范围缺口。
• 使用SSE进行公共托管部署，以便非Claude客户端可以远程使用服务器。
• 用于发现工具的多语言SDK客户端，因此非MCP集成可以获得相同的路由优势。

学分

• 最初由 grll 作为 opendata-mcp.
• 围绕单服务器“元mcp”模型进行分叉和重塑。
• 建于 Anthropic的开源MCP规范.

许可证

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