Data.gov MCP Server 使用说明

项目简介

Data.gov MCP Server 是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在为 LLM 应用提供访问美国政府开放数据平台 Data.gov 的能力。通过此 MCP 服务器，用户可以使用各种工具搜索、查询和获取 Data.gov 上的数据集信息和资源，从而在 LLM 应用中便捷地利用政府开放数据。

主要功能点

数据集搜索 (package_search): 允许用户通过关键词在 Data.gov 上搜索数据集（package）。支持按关键词、排序方式、结果数量和起始位置进行搜索。
数据集详情查询 (package_show): 允许用户根据数据集的 ID 或名称获取指定数据集的详细信息。
数据组列表 (group_list): 列出 Data.gov 上的数据组（group），可以根据字段排序、限制数量和偏移量查询，并可选择返回所有字段。
标签列表 (tag_list): 列出 Data.gov 上的标签（tag），支持通过关键词查询标签，并可选择返回所有字段。
资源访问 (datagov://resource/{url}): 允许用户通过 Data.gov 资源的 URL 直接访问资源内容。服务器会将资源内容转换为 Data URI 格式返回，方便 LLM 应用直接使用。

安装步骤

全局安装 npm 包: 打开终端并执行以下命令，全局安装 'datagov-mcp-server'：

npm install -g @melaodoidao/datagov-mcp-server

服务器配置

要将 Data.gov MCP Server 集成到 MCP 客户端（如 Cline），您需要配置客户端的 MCP 服务器设置。以下是 'cline_mcp_settings.json' 或 'claude_desktop_config.json' 文件中需要添加的配置信息：

{
  "mcpServers": {
    "datagov": {  // 服务器名称，可以自定义，将在客户端中用于标识此服务器
      "command": "datagov-mcp-server", // 启动服务器的命令，这里是全局安装后可直接执行的命令名
      "args": [], // 启动命令的参数，此服务器无需额外参数
      "env": {}   // 环境变量，此服务器无需设置环境变量
    }
  }
}

请注意，'cline_mcp_settings.json' 通常位于 '~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/' (macOS) 或相应的用户配置目录下。'claude_desktop_config.json' 则位于 '~/Library/Application Support/Claude/' (macOS)。请根据您的 MCP 客户端类型找到对应的配置文件并进行配置。

基本使用方法

配置完成后，在支持 MCP 协议的 LLM 客户端中，您可以使用以下方式调用 Data.gov MCP Server 提供的功能：

调用工具: 在 LLM 客户端中，指定服务器名称为 'datagov'，然后调用相应的工具名称（如 'package_search', 'package_show', 'group_list', 'tag_list'）并传递工具所需的参数。例如，要搜索关于 "climate change" 的数据集，可以调用 'datagov.package_search' 工具，并设置参数 '{"q": "climate change"}'。
访问资源: 使用 'datagov://resource/{url}' 格式的 URI 访问 Data.gov 上的资源。将 '{url}' 替换为实际的 Data.gov 资源 URL 即可。例如，'datagov://resource/https%3A%2F%2Fcatalog.data.gov%2Fdataset%2F5e647625-81d5-42ab-b213-f14988563237%2Fresource%2F75441119-c554-4586-a695-4f85b3462a42%2Fdownload%2Fdata-zip.zip' 将访问指定 URL 的资源。请注意 URL 需要进行 URI 编码。

具体的使用方式和界面操作请参考您使用的 MCP 客户端的文档。

关键词