Mcpservers

🚀 美国Data.gov MCP服务器

美国政府公共数据门户（data.gov）的API模型上下文协议（MCP）服务器。它能让AI工具便捷访问美国公共数据，为各类应用提供数据支持。

🚀 快速开始

本项目将美国政府data.gov门户的API封装为MCP服务器，使AI工具能够轻松访问和利用美国公共数据。以下是使用这些服务器的基本步骤：

1. 安装所需的MCP服务器。
2. 配置相关的AI工具，如Claude Desktop或Cline。
3. 利用服务器提供的工具进行数据查询。

✨ 主要特性

• 标准化访问：通过统一的MCP接口使用各种公共API。
• AI工具集成：可直接从Claude、Cline等AI助手访问公共数据。
• 易于安装：可通过pip或uv进行安装。
• 类型安全：使用Pydantic进行强类型验证。
• 开发者友好：基于模板可快速创建服务器。

📦 安装指南

使用UV（推荐）

# 人口普查数据服务器
uv pip install us-data-mcp.census-data

# SEC EDGAR服务器
uv pip install us-data-mcp.sec-edgar

# FDA药品服务器
uv pip install us-data-mcp.fda-drugs

# 劳工统计局服务器
uv pip install us-data-mcp.bls-labor

# EPA空气质量服务器
uv pip install us-data-mcp.epa-airquality

使用pip

# 人口普查数据服务器
pip install us-data-mcp.census-data

# SEC EDGAR服务器
pip install us-data-mcp.sec-edgar

# FDA药品服务器
pip install us-data-mcp.fda-drugs

# 劳工统计局服务器
pip install us-data-mcp.bls-labor

# EPA空气质量服务器
pip install us-data-mcp.epa-airquality

Claude Desktop配置

将MCP服务器添加到Claude Desktop配置文件中：

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

{
  "mcpServers": {
    "us-data-mcp.census-data": {
      "command": "uvx",
      "args": ["us-data-mcp.census-data@latest"],
      "env": {
        "CENSUS_API_KEY": "your-api-key-here"
      }
    },
    "us-data-mcp.sec-edgar": {
      "command": "uvx",
      "args": ["us-data-mcp.sec-edgar@latest"]
    },
    "us-data-mcp.fda-drugs": {
      "command": "uvx",
      "args": ["us-data-mcp.fda-drugs@latest"]
    },
    "us-data-mcp.bls-labor": {
      "command": "uvx",
      "args": ["us-data-mcp.bls-labor@latest"],
      "env": {
        "BLS_API_KEY": "your-api-key-here"
      }
    },
    "us-data-mcp.epa-airquality": {
      "command": "uvx",
      "args": ["us-data-mcp.epa-airquality@latest"],
      "env": {
        "EPA_AQS_EMAIL": "your-email@example.com",
        "EPA_AQS_KEY": "your-api-key-here"
      }
    }
  }
}

注意：使用@latest可确保始终运行最新版本。

Cline配置

在VS Code的Cline扩展中配置MCP服务器：.vscode/cline_mcp_settings.json

{
  "mcpServers": {
    "us-data-mcp.census-data": {
      "command": "python",
      "args": ["-m", "us_data_mcp.census_data.server"],
      "env": {
        "CENSUS_API_KEY": "your-api-key-here"
      }
    }
  }
}

💻 使用示例

人口普查局数据（us-data-mcp.census-data）

环境变量

export CENSUS_API_KEY="your-api-key-here"  # 从https://api.census.gov/data/key_signup.html获取

可用工具

• search_population：按地理区域搜索人口数据
  • 参数：
    • year：数据年份（例如，2020）
    • state：州FIPS代码（2位数字）
    • county：县FIPS代码（3位数字，可选）
    • variables：要检索的人口普查变量列表
• search_economic：搜索经济指标
  • 参数：
    • year：数据年份
    • dataset：数据集名称（例如，"acs/acs5"）
    • variables：经济变量列表
    • geography：地理级别（州、县等）

使用示例

"获取2020年加利福尼亚州的人口数据"
"查找纽约县的家庭收入中位数"
"显示得克萨斯州的就业统计数据"

SEC EDGAR（us-data-mcp.sec-edgar）

环境变量

无需API密钥 - 使用公共SEC EDGAR API。

可用工具

• search_company：按名称、股票代码或CIK搜索公司
  • 参数：
    • query：公司名称、股票代码或CIK
• get_company_facts：获取公司财务事实（XBRL数据）
  • 参数：
    • cik：中央索引键
• get_insider_trades：获取最近的内幕交易报告（Form 4）
  • 参数：
    • cik：中央索引键
    • limit：要检索的交易数量（默认：20）
• get_form_types：获取SEC表格类型的参考列表

使用示例

"查找苹果公司最近的10 - K文件"
"搜索股票代码为MSFT的公司"
"获取CIK为0000320193的公司的财务事实"
"显示特斯拉公司最近的内幕交易情况"

FDA药品信息（us-data-mcp.fda-drugs）

环境变量

无需API密钥 - 使用公共openFDA API。

可用工具

• search_drugs：搜索药品数据库
  • 参数：
    • brand_name：药品品牌名称（可选）
    • generic_name：通用名称（可选）
    • application_number：FDA申请编号（可选）
    • limit：最大结果数（默认：10）
• search_recalls：搜索药品召回信息
  • 参数：
    • product_description：产品描述
    • classification：召回分类（I、II、III）
    • status：召回状态（进行中、已完成）
    • limit：最大结果数（默认：10）
• search_adverse_events：搜索不良事件报告
  • 参数：
    • drug_name：药品名称
    • reaction：特定反应/副作用（可选）
    • limit：最大结果数（默认：10）
• search_devices：搜索医疗设备
  • 参数：
    • device_name：设备名称
    • limit：最大结果数（默认：10）
• search_all_recalls：搜索所有FDA召回信息（食品、药品、设备）
  • 参数：
    • category：类别（食品、药品、设备）
    • product_description：产品名称或关键词
    • limit：最大结果数（默认：10）

使用示例

"查找立普妥的FDA批准信息"
"搜索最近的食品召回信息"
"获取心脏瓣膜设备的信息"
"获取阿司匹林的不良事件报告"

劳工统计局（us-data-mcp.bls-labor）

环境变量

export BLS_API_KEY="your-api-key-here"  # 从https://www.bls.gov/developers/api_signature_v2.htm获取

可用工具

• get_series_data：获取劳工统计局系列ID的数据
  • 参数：
    • series_ids：系列ID列表（例如，["LNS14000000"]）
    • start_year：开始年份
    • end_year：结束年份
• get_common_series：获取常见系列ID的参考列表

使用示例

"获取2020年至2023年的全国失业率"
"查找用于通货膨胀分析的CPI数据"
"显示非农就业总统计数据"

EPA空气质量（us-data-mcp.epa-airquality）

环境变量

export EPA_AQS_EMAIL="your-email@example.com"
export EPA_AQS_KEY="your-api-key-here"  # 从https://aqs.epa.gov/data/api/signup获取

可用工具

• get_daily_air_quality：获取每日空气质量摘要
  • 参数：
    • param_code：污染物参数代码（例如，"44201"表示臭氧）
    • bdate：开始日期（YYYYMMDD）
    • edate：结束日期（YYYYMMDD）
    • state：2位州FIPS代码
    • county：3位县FIPS代码（可选）
• get_common_aqs_parameters：获取污染物代码的参考列表

使用示例

"获取2023年7月加利福尼亚州的臭氧水平"
"查找洛杉矶县的PM2.5水平"
"显示EPA数据的常见空气污染物代码"

📚 详细文档

开发环境设置

# 克隆仓库
git clone https://github.com/sechan9999/us-data-mcp-servers.git
cd us-data-mcp-servers

# 安装UV
curl -LsSf https://astral.sh/uv/install.sh | sh

# 安装依赖项
uv sync --dev

🚀 快速创建新的MCP服务器

使用自动化脚本（推荐）

最快的方法是使用提供的模板生成脚本：

# 运行交互式脚本
uv run python scripts/create_mcp_server.py

该脚本将逐步引导你完成过程，并在几分钟内生成一个新的MCP服务器。

手动使用模板

# 安装Cookiecutter（如果需要）
uv pip install cookiecutter

# 从模板创建新服务器
uv run cookiecutter template/ -o src/

有关详细的模板使用说明，请参阅 TEMPLATE_USAGE.md。

有关完整的开发者指南，请参阅 CONTRIBUTING.md。

运行测试

# 运行所有测试
uv run pytest

# 运行特定服务器的测试
uv run pytest src/census-data/tests/

API密钥

🤝 贡献

欢迎贡献代码！请参阅 CONTRIBUTING.md 获取指南。

📄 许可证

本项目采用MIT许可证 - 详情请参阅 LICENSE。

👏 致谢

本项目受 韩国data.go.kr MCP服务器 项目的启发。

📚 资源

• 模型上下文协议文档
• Data.gov开发者资源
• 人口普查API文档
• SEC EDGAR API
• openFDA API
• 劳工统计局API文档
• EPA AQS API