GCC MCP Pilot

格洛斯特郡议会MCP服务器

Azure Functions v4 MCP（模型上下文协议）服务器，用于通过其ModernGov SOAP API访问来自格洛斯特郡所有7个议会的民主数据。

当前状态

支持的议会（7）

看 docs/COUNCIL_identifier.md 获取API调用中所需的确切理事会名称字符串。

项目结构

GCC-MCP-Pilot/
├── package.json
├── host.json
├── src/
│   ├── index.js                    # Azure Functions entry point
│   └── functions/
│       ├── mcp.js                  # Main MCP HTTP endpoint
│       └── test-soap.js            # SOAP exploration endpoint
├── lib/
│   ├── mcp-handler.js              # MCP JSON-RPC protocol handler
│   ├── moderngov-client.js         # SOAP client with multi-council support
│   ├── council-config.js           # Council configuration loader
│   └── tools/
│       ├── list-committees.js
│       ├── get-councillors.js
│       ├── get-councillors-by-ward.js
│       ├── get-meetings.js
│       ├── get-meeting-details.js
│       ├── get-attachment.js
│       └── analyze-meeting-document.js
├── json/
│   └── Gloucestershire/
│       ├── councils.json           # Council endpoints
│       └── council_data/
│           ├── Gloucester_City_Council/
│           │   ├── committees.json
│           │   └── wards.json
│           ├── Tewkesbury_Borough_Council/
│           │   ├── committees.json
│           │   └── wards.json
│           └── ... (5 more councils)
└── docs/
    ├── COUNCIL_IDENTIFIERS.md      # Council reference guide
    └── DEMOCRATIC_DATA_INTEGRITY.md

可用的MCP工具

必需参数

重要：大多数工具需要 council_name 带a的参数 精确区分大小写的匹配:

✅ 对的： "Gloucester City Council" ❌ 错误： "gloucester city council" （案例不匹配） ❌ 错误： "Gloucester Council" （缺少“城市”） ❌ 错误： "GCC" （缩写）

使用 list_available_councils 第一 获取确切的议会名称！

民主数据完整性

重要： 此MCP服务器返回民主决策的官方法定记录。使用这些数据的AI助手必须遵循特殊的处理规则：

• 逐字引用：必须准确引用委员会的建议、决定、决议和动议
• 始终链接源：包括 source_url 或 web_page 来自响应的链接
• 单独解释：明确区分官方记录和解释

看 docs/DEMOCRATIC_DATA_INTEGRITY.md 完整的指南。

数据分类字段

工具响应包括用于识别官方内容的元数据：

{
  "data_classification": "official_record",
  "is_official_record": true,
  "official_sections": ["recommendations", "decisions", "legal_implications"],
  "source": {
    "system": "ModernGov",
    "council": "Gloucester City Council",
    "url": "https://democracy.gloucester.gov.uk/..."
  }
}

看 文档/注释_BLOB_CLIENT_PERFORMANCE.md blob客户端重用和延迟指南 mcp-notes.

本地开发

先决条件

• Node.js 18+
• Azure功能核心工具v4

设置

cd GCC-MCP-Pilot
npm install

启动服务器

func start

服务器将在以下时间启动 http://localhost:7071

测试

测试MCP协议

# Test initialize - check server info and available councils
curl -X POST http://localhost:7071/api/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"initialize","params":{},"id":1}'

# Test tools/list - see all available tools
curl -X POST http://localhost:7071/api/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"tools/list","id":2}'

# Test list_available_councils - discover councils
curl -X POST http://localhost:7071/api/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"tools/call","params":{"name":"list_available_councils","arguments":{}},"id":3}'

# Test list_committees - get committees for a specific council
curl -X POST http://localhost:7071/api/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"tools/call","params":{"name":"list_committees","arguments":{"council_name":"Gloucester City Council"}},"id":4}'

# Test list_committees - get all councils' committees
curl -X POST http://localhost:7071/api/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"tools/call","params":{"name":"list_committees","arguments":{}},"id":5}'

# Test get_councillors
curl -X POST http://localhost:7071/api/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"tools/call","params":{"name":"get_councillors","arguments":{"council_name":"Gloucester City Council"}},"id":6}'

探索SOAP响应

使用test-soap端点查看来自ModernGov的实际XML响应：

# List available operations
curl http://localhost:7071/api/test-soap

# Test GetCommittees
curl http://localhost:7071/api/test-soap/GetCommittees

# Test GetCouncillorsByWard
curl http://localhost:7071/api/test-soap/GetCouncillorsByWard

# Test GetMeetings with committee ID
curl "http://localhost:7071/api/test-soap/GetMeetings?committeeId=544"

# Test GetMeeting with meeting ID
curl "http://localhost:7071/api/test-soap/GetMeeting?meetingId=123456"

故障排除

“未从ChatGPT/Claude获取任何信息”

如果您看到诸如“未获取任何信息”之类的错误，请检查：

1. 议会名称参数：确保精确区分大小写的匹配

   # Check available councils first
   curl -X POST http://localhost:7071/api/mcp \
     -H "Content-Type: application/json" \
     -d '{"jsonrpc":"2.0","method":"tools/call","params":{"name":"list_available_councils","arguments":{}},"id":1}'

1. 工具响应格式：工具返回以MCP内容格式包装的JSON：

   {
     "result": {
       "content": [{
         "type": "text",
         "text": "{ ...actual data... }"
       }]
     }
   }

1. 错误响应：错误也以内容格式包装 isError: true:

   {
     "result": {
       "content": [{
         "type": "text",
         "text": "{\"error\": \"council_name is required\"}"
       }],
       "isError": true
     }
   }

1. 检查服务器日志：Azure Functions日志显示所有工具调用和错误：

   # In local development
   func start
   # Watch the console output when making requests

1. 手动测试：使用上面的curl命令验证工具是否正常工作

常见错误

调试步骤

1. 测试工具/清单 验证MCP服务器是否正在响应
2. 测试列表_可用_委员会 验证加载的议会配置
3. 测试列表_提交 有专门的委员会来验证数据访问
4. 检查Azure功能日志 有关详细的错误消息
5. 验证MCP客户端配置 在ChatGPT/Claude设置中

MCP客户端配置

ChatGPT配置

在ChatGPT设置中，配置MCP服务器：

{
  "mcpServers": {
    "gloucestershire-councils": {
      "url": "https://your-function-app.azurewebsites.net/api/mcp",
      "apiKey": "your-api-key-if-needed"
    }
  }
}

Claude桌面配置

添加 claude_desktop_config.json:

{
  "mcpServers": {
    "gloucestershire-councils": {
      "command": "node",
      "args": ["/path/to/GCC-MCP-Pilot/mcp-stdio-wrapper.js"],
      "env": {
        "MODERNGOV_ENDPOINT": "https://democracy.gloucester.gov.uk/mgWebService.asmx"
      }
    }
  }
}

环境变量

现在已在中配置了理事会终结点 json/Gloucestershire/councils.json.

MCP协议参考

此服务器实现了模型上下文协议（MCP）JSON-RPC接口：

方法

• initialize -返回服务器功能、委员会列表和指令
• tools/list -返回8个可用的JSON模式验证工具
• tools/call -执行工具并返回结果
• ping -健康检查

响应格式

所有响应均遵循JSON-RPC 2.0格式：

{
  "jsonrpc": "2.0",
  "result": { ... },
  "id": 1
}

工具调用结果以MCP内容格式包装：

{
  "jsonrpc": "2.0",
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{ ...JSON result with date context wrapper... }"
      }
    ]
  },
  "id": 1
}

部署

使用以下方式部署到Azure功能：

func azure functionapp publish 

文档

• 理事会标识符参考 -有效议会名称的完整指南
• 民主数据完整性 -官方记录处理指南

许可证

麻省理工学院