政府数据查询服务

ModGov MCP Server是一个基于Cloudflare Workers的政府数据查询服务,提供对ModernGov系统下议会信息、议员、委员会和会议等数据的查询功能。

  • by jadu
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 jadu/modgov-mcp-cloudflare

使用说明

Cloudflare工作人员的ModGov MCP服务器

这是ModGov MCP服务器的Cloudflare Workers实现,它提供了与ModernGov委员会API交互的工具。它允许您使用ModernGov系统从任何议会查询议会信息、议员、委员会、会议等。

实时部署

生产URL: https://modgov-mcp-cloudflare.paul-stanton.workers.dev/mcp

特性

  • 理事会搜索:使用模糊匹配按名称、地区或类型查找议会
  • 议员信息:按选区、选区ID或邮政编码获取议员详细信息
  • 委员会管理:列出委员会及其会议
  • 会议信息:获取会议详细信息,包括日期、时间和地点
  • 基于区域的查找:查找特定地区的所有议会
  • 44英国议会:预先配置的ModernGov议会数据库

传输协议

服务器支持两种MCP传输协议:

端点 传输 建议用于
/mcp 流式HTTP (默认) 游标,现代MCP客户端
/sse 传统SSE 旧客户端,通过mcp远程访问Claude Desktop

可用工具

  • find_council:使用模糊匹配按名称查找议会
  • search_councils:搜索具有可配置置信阈值的理事会
  • get_council_by_region:获得特定地区的所有议会
  • get_councillors_by_ward:按选区组织议员
  • get_councillors_by_ward_id:获取议员的特定选区ID
  • get_councillors_by_postcode:获取特定邮政编码的议员
  • get_committees:召集所有委员会组成一个理事会
  • get_meetings:为特定委员会召开会议

入门指南

  1. 克隆此存储库:

    git clone https://github.com/yourusername/modgov-mcp-cloudflare.git
    cd modgov-mcp-cloudflare
    
  2. 安装依赖项:

    npm install
    
  3. 在本地运行:

    npm run dev
    
  4. 部署到Cloudflare Workers:

    npm run deploy
    

配置

游标IDE(推荐)

添加到您的 ~/.cursor/mcp.json:

{
  "mcpServers": {
    "modgov-mcp-remote": {
      "url": "https://modgov-mcp-cloudflare.paul-stanton.workers.dev/mcp"
    }
  }
}

备注:使用 /mcp 流式HTTP传输的端点。不需要自定义标头-游标会自动处理它们。

Cloudflare AI游乐场

  1. 首选https://playground.ai.cloudflare.com/
  2. 输入MCP服务器URL: https://modgov-mcp-cloudflare.paul-stanton.workers.dev/sse
  3. 现在,您可以直接在操场上使用ModGov工具!

克劳德桌面版

  1. 跟随 Anthropic的快速入门
  2. 在Claude Desktop中,转到“设置”>“开发人员”>“编辑配置”
  3. 使用此配置进行更新:
{
  "mcpServers": {
    "modgov": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://modgov-mcp-cloudflare.paul-stanton.workers.dev/sse"
      ]
    }
  }
}

本地开发

{
  "mcpServers": {
    "modgov-local": {
      "url": "http://localhost:8787/mcp"
    }
  }
}

示例用法

以下是一些您可以尝试的示例查询:

  1. 查找理事会:

    Find information about Lichfield District Council
    
  2. 通过邮政编码获取议员信息:

    Who are the councillors for postcode WS13 6HX?
    
  3. 召开委员会会议:

    What meetings are scheduled for the Planning Committee at Leeds City Council?
    
  4. 按地区搜索:

    Show me all councils in the West Midlands
    

发展

要添加新工具或修改现有工具,请编辑 src/index.ts 文件。服务器使用:

  • ModgovClient:处理对ModernGov终结点的API调用
  • CouncilMatcher:为议会搜索提供模糊匹配
  • councils.json:包含ModernGov议会的数据库

贡献

  1. 分叉存储库
  2. 创建要素分支
  3. 进行更改
  4. 提交拉取请求

许可证

MIT许可证-有关详细信息,请参阅许可证文件