Gov.uk MCP Server

一个全面的模型上下文协议（MCP）服务器，提供访问27个英国政府数据源和服务。适用于Claude Desktop和其他兼容MCP的客户端。 注意：这是一个业余项目，大约80%是用Vibe编码的，可能会有问题，仅用于演示目的。

🌟 特性

• 33个政府API：包括公司注册处、议会、NHS、交通等

尝试： “距离SW1A 1AA最近的五个邮编是什么？” “下一个银行假日是什么时候？” “我如何从Brixton到St Pancras？” “Circle线的状态是什么？” “我最近的医院在哪里？” “我的议员是谁？” “他们的投票记录是什么？”

等等。

📦 安装

# 克隆仓库
git clone https://github.com/YOUR_USERNAME/govmcp.git
cd govmcp

# 安装依赖
pip install -e .

# 或者安装开发依赖
pip install -e ".[dev]"

🔑 API密钥设置

在项目根目录创建一个.env文件：

# Companies House工具所需
COMPANIES_HOUSE_API_KEY=your_companies_house_key

# EPC工具所需
EPC_API_KEY=your_email:your_epc_key

# 可选（没有密钥也可以工作，但速率限制较低）
TFL_API_KEY=your_tfl_key

API密钥要求

必需的API（2个）：

• Companies House API：https://developer.company-information.service.gov.uk/
• EPC API：https://epc.opendatacommunities.org/

可选的API（1个）：

• TfL API：https://api-portal.tfl.gov.uk/（没有密钥也可以工作，但有速率限制）

无需密钥（24个工具）： 邮编查询、食品卫生、银行假日、Gov.uk搜索、洪水预警、警察犯罪、法院、慈善机构、NHS、立法、CQC、议会工具

🚀 使用方法

与Claude Desktop一起使用

添加到你的claude_desktop_config.json：

{
  "mcpServers": {
    "gov-uk": {
      "command": "python",
      "args": ["-m", "gov_uk_mcp.server"],
      "env": {
        "COMPANIES_HOUSE_API_KEY": "your_key_here",
        "EPC_API_KEY": "your_email:your_key_here"
      }
    }
  }
}

独立运行（开发用途）

python -m gov_uk_mcp.server

🛠️ 可用工具（33个）

交通（6个）

• get_tube_status - 所有地铁线路状态
• get_line_status - 特定线路状态
• plan_journey - 行程规划，带逐步方向
• get_bike_points - Santander自行车点可用性
• get_road_status - 主要道路状况
• search_stops - 查找公交站、车站等

商业与金融（6个）

• search_companies, get_company, get_company_officers, get_company_filing_history
• search_charities, get_charity

地理位置（5个）

• lookup_postcode, nearest_postcodes
• search_food_establishments, get_flood_warnings, get_crime_by_postcode

医疗保健（5个）

• find_gp_surgeries, find_hospitals, find_pharmacies
• search_cqc_providers, get_cqc_provider

议会（5个）

• find_mp, search_hansard, get_voting_record
• search_divisions, search_questions, get_questions_by_mp

其他服务（4个）

• search_epc_by_postcode, find_courts, search_govuk, get_bank_holidays, search_legislation

🧪 测试

# 运行所有测试
pytest

# 带覆盖率报告
pytest --cov=gov_uk_mcp --cov-report=html

# 特定测试
pytest tests/test_validation.py -v

📝 许可证

MIT - 详见LICENSE

🙏 致谢

• MCP by Anthropic
• 英国政府开放数据API
• Python生态系统

---

为英国开发者社区打造 🇬🇧