魁北克MCP数据
  
服务器 模型上下文协议(MCP) 它允许人工智能代理(Claude、ChatGPT、Gemini等)搜索、探索和分析来自 魁北克数据,德拉 蒙特利尔市 以及魁北克政府的地理空间服务(IGO),直接通过对话。
不要手动浏览门户,只需询问您的问题: _“蒙特利尔有哪些犯罪数据集?»_ 或 _“2025年每个地区有多少犯罪行为?»_ 并获得即时响应,包括SQL分析。
主要特点: 数据存储上的SQL查询|下载非数据存储资源(CSV、JSON、GeoJSON)|一次调用中的搜索+查询↔ 4326 |空间交点| OGC地理空间层| 3数据源| 28工具
*英文版本如下*
______________________________________________________________________
请求示例
以下是您可以直接向人工智能代理询问的问题:
1.SQL分析-邻里犯罪
“蒙特利尔犯罪率最高的10个街区是什么?»
| 范围 | PDQ | 总动作 |
|---|---|---|
| 1 | 38(中南部) | 24 942 |
| 2 | 21(皇家山高原) | 23 041 |
| 3 | 20(玛丽维尔东部) | 20 135 |
| 4 | 48(圣洛朗) | 16 163 |
| 5 | 26(内日) | 15955 |
*代理自动执行SQL查询 GROUP BY 在蒙特利尔的数据存储中。*
2.多工具探索-公共树
“找到蒙特利尔公共树木的数据,探索结构,然后告诉我每个自治区有多少棵树。»
代理链接3个工具: search_montreal_datasets 为了找到游戏, query_montreal_data 要浏览列,然后 query_montreal_sql 用于聚合。结果: 333556棵树 Mercier Hochelaga Maisonneuve位于13个区(37871)。
3.目录统计
“有多少组织发布魁北克数据?»
139个组织, 1584个数据集蒙特利尔市以383场比赛(占目录的24%)位居榜首,其次是拉瓦尔(133场)和MELCCFP(119场)。
4.时间趋势
“蒙特利尔犯罪的每月趋势是什么?»
代理通过SQL查询识别春季/夏季的峰值(~2700/月)和冬季的下降(~1700-2000/月) GROUP BY 关于日期。
5.地理空间数据-文化遗产
“魁北克文化遗产有哪些地理空间层?»
该官员询问了WFS IGO,发现了文化部的7层:国家遗产地、申报地、城市、保护地-以及完整的计划(名称、地址、施工期、法律地位)。
______________________________________________________________________
将IA代理连接到MCP服务器
使用托管端点(即将可用)或在本地启动。配置取决于您的客户:
克劳德代码 | 克劳德桌面版 | ChatGPT | 光标 | VS Code | Gemini CLI | Le Chat(米斯特拉尔) | 帆板运动
克劳德代码
claude mcp add --transport http donneesqc http://localhost:8000/mcp注: 如果Claude Code阻止对外部API的网络调用,请将域添加到.claude/settings.json: ``json { "permissions": { "allow": [ "WebFetch(domain:registreentreprises.gouv.qc.ca)", "WebFetch(domain:www.donneesquebec.ca)" ] } }``
克劳德桌面版
在Claude桌面配置文件中添加:
{
"mcpServers": {
"donneesqc": {
"command": "npx",
"args": ["mcp-remote", "http://localhost:8000/mcp"]
}
}
}ChatGPT
*仅限付费套餐。* 进去 Settings > Apps and connectors >activez le 开发者模式 > Add new connector 使用URL http://localhost:8000/mcp.
光标
{
"mcpServers": {
"donneesqc": {
"url": "http://localhost:8000/mcp",
"transport": "http"
}
}
}VS Code
添加到 mcp.json (发射 MCP:打开用户配置 从订单调色板):
{
"servers": {
"donneesqc": {
"url": "http://localhost:8000/mcp",
"type": "http"
}
}
}Gemini CLI
添加到 ~/.gemini/settings.json :
{
"mcpServers": {
"donneesqc": {
"httpUrl": "http://localhost:8000/mcp"
}
}
}Le Chat(米斯特拉尔)
Intelligence > Connectors > Add connector > Custom MCP Connector >网址: http://localhost:8000/mcp.
帆板运动
添加到 ~/.codeium/windsurf/mcp_config.json :
{
"mcpServers": {
"donneesqc": {
"command": "npx",
"args": ["-y", "mcp-remote", "http://localhost:8000/mcp"]
}
}
}本地启动
使用Docker(推荐)
git clone https://github.com/Stefen-Taime/donneesqc-mcp.git
cd donneesqc-mcp
docker compose up -d安装手册
git clone https://github.com/Stefen-Taime/donneesqc-mcp.git
cd donneesqc-mcp
uv sync
cp .env.example .env
set -a && source .env && set +a
uv run python main.py环境变量:
| 变量 | 缺陷 | 描述 |
|---|---|---|
MCP_HOST | 0.0.0.0 | 收听地址。使用 127.0.0.1 在地方发展中。 |
MCP_PORT | 8000 HTTP服务器端口。 | |
MCP_ENV | local 环境名称(Sentry)。 | |
DQ_API_URL | https://www.donneesquebec.ca/recherche/api/3/action | Data Québec的CKAN API。 |
MTL_API_URL | https://donnees.montreal.ca/api/3/action | API蒙特利尔CKAN。 |
GEO_WFS_URL | https://geoegl.msp.gouv.qc.ca/ws/igo_gouvouvert.fcgi | 端点WFS IGO。 |
GEO_WMS_URL | https://geoegl.msp.gouv.qc.ca/ws/igo_gouvouvert.fcgi | 端点WMS IGO。 |
GEOCODER_URL | https://geoegl.msp.gouv.qc.ca/apis/icherche | 地理编码API地址魁北克(iCherche)。 |
HTTP_TIMEOUT | 30.0 HTTP超时(秒)。 | |
HTTP_MAX_RETRIES | 3 | 发生网络错误或5xx时的尝试次数。 |
DOWNLOAD_MAX_BYTES | 52428800 (50 MB) | 文件上传的最大大小。 |
LOG_LEVEL | INFO | Python日志级别。 |
SENTRY_DSN | _(未定义)_ | DSN哨兵负责监控 |
运输
用 官方Python MCP SDK. 仅限流式HTTP -不支持STDIO和SSE。
终点:
POST /mcp--JSON-RPC消息GET /health-健康探头
可用工具(28)
魁北克数据-数据集(9个工具)
| 输出 | 描述 |
|---|---|
search_datasets | 按关键字、组织、标签搜索 |
get_dataset_info | 数据集的完整元数据 |
list_dataset_resources | 列出游戏的文件/资源 |
get_resource_info | 特定资源的详细信息 |
query_resource_data | 使用过滤器和分页查询数据存储 |
query_resource_sql | SQL直接 -聚合、连接、子查询 |
list_organizations | 部委、城市、机构 |
get_organization_info | 组织的详细信息 |
get_catalog_stats | 全球目录统计 |
蒙特利尔市(3个工具)
| 输出 | 描述 |
|---|---|
search_montreal_datasets | 搜索data.montreal.ca |
query_montreal_data | 查询蒙特利尔数据存储 |
query_montreal_sql 蒙特利尔数据的SQL |
数据访问(2个工具)
| 输出 | 描述 |
|---|---|
download_resource | 下载和阅读资源 非数据存储 (CSV、JSON、geojson、xlsx) |
preview_resource | 智能预览-图表(列+类型)和前5行 |
智能与用户体验(4个工具)
| 输出 | 描述 |
|---|---|
find_and_query | 复合 -一次调用中的搜索→资源→查询 |
suggest_sql | 从资源的模式生成SQL骨架 |
compare_datasets | 两个游戏之间的差异(列、卷、标签、组织) |
auto_detect_resource | 自动找到最佳 resource_id 从一个名字 |
地理空间(8个工具)
| 输出 | 描述 |
|---|---|
list_geospatial_layers | 来自IGO的WFS/WMS层 |
get_geospatial_features | 来自WFS的GeoJSON实体 |
describe_geospatial_layer | 图层图(字段、类型) |
get_map_url | WMS地图图像URL |
geocode | 魁北克地址→LAT/LNG联系方式(通过魁北克地址) |
reverse_geocode | 联系方式LAT/LNG→魁北克地址 |
convert_coordinates | 转换EPSG:32198(兰伯特MTQ)↔ EPSG:4326(WGS84) |
spatial_intersection | 哪个地区/MRC/市/区包含点 |
系统(2个工具)
| 输出 | 描述 |
|---|---|
get_version | 服务器版本、Python、可用功能 |
list_tools_with_examples | 元内省-列出所有工具及其使用示例 |
测试
# Lancer tous les tests
uv run pytest
# Mode verbeux
uv run pytest -v
# Test interactif avec MCP Inspector
npx @modelcontextprotocol/inspector --http-url "http://127.0.0.1:8000/mcp"贡献者
- 1功能=1 PR
- 所有代码必须在提交前由人工审查和测试。
# Lint et formatage
uv run ruff check --fix && uv run ruff format
# Vérification de types
uv run ty check
# Installer les hooks pre-commit
uv run pre-commit install发布
./tag_version.sh 1.0.0 # Créer une release
./tag_version.sh 1.0.0 --dry-run # Aperçu数据来源
- 魁北克数据 -基于CKAN的省级门户(政府+市)
- donnees.montreal.ca -魁北克最富有的蒙特利尔市政门户
- IGO -开放地理信息基础设施、OGC服务(WMS/WFS)
- 地址魁北克(iCherche) -地理编码和反向地理编码
许可证
MIT-查看 许可证.
______________________________________________________________________
英语
MCP服务器,允许AI代理(Claude、ChatGPT、Gemini等)从以下位置搜索、探索和分析开放数据集 魁北克数据, 蒙特利尔市,以及魁北克的地理空间服务(IGO)通过对话。
不要手动浏览门户网站,只需问以下问题 _“蒙特利尔有哪些犯罪数据集?”_ 或 _“2025年每个行政区有多少犯罪行为?”_ 并获得即时答案,包括SQL支持的分析。
所有设置说明、工具说明和环境变量都记录在上面的法语部分。配置代码段(JSON、bash)与语言无关,按原样应用。
快速开始
git clone https://github.com/Stefen-Taime/donneesqc-mcp.git
cd donneesqc-mcp
docker compose up -d然后将您的AI客户端连接到 http://localhost:8000/mcp --看看 上面的连接部分 用于客户端特定的配置。
可用工具(28)
- 魁北克数据 (9) :数据集搜索、元数据、DataStore查询、直接SQL、组织、目录统计
- 蒙特利尔市 (3) :数据集搜索、DataStore查询、SQL
- 数据访问 (2) :非DataStore文件下载(CSV、JSON、GeoJSON、XLSX),智能预览(模式+5行)
- 智能与用户体验 (4) :复合搜索+查询、SQL建议、数据集比较、自动资源检测
- 地理空间 (8) :WFS/WMS图层、GeoJSON功能、地理编码、反向地理编码、EPSG:32198↔4326转换,空间交叉口
- 系统 (2) :版本信息,带有示例的工具列表(元内省)
______________________________________________________________________
*一个项目 MCS版 -蒙特利尔,魁北克*
