统计数据集查询服务

一个基于HTTP/SSE的无认证公共MCP服务器,提供浏览数据模式和查询数据的功能,适用于数据分析场景。

  • by sahilTiwariiiii
  • TypeScript
  • 混合部署
  • 更新于
在 GitHub 查看 sahilTiwariiiii/mcp_server

使用说明

加拿大统计局LODE数据集的MCP服务器(HTTP/SSE)

概述

  • 通过HTTP+SSE的公共无身份验证模型上下文协议(MCP)服务器。
  • 提供紧凑的工具,用于浏览模式和查询具有安全限制的数据。
  • 在VS Code MCP聊天中本地测试;可部署到EC2以供公众访问。

链接

  • Docker镜像:https://hub.docker.com/r/samrat156/mcpserver
  • GitHub仓库:https://github.com/sahilTiwariiiii/mcp_server
  • 实时EC2(SSE):[http://15.206.164.94:5000/sse]
  • 同伴POST:[http://15.206.164.94:5000/sse]
  • 测试媒体(视频/照片):[https://drive.google.com/drive/folders/1zBW7JeyspttDaB0jnbvPWusZDf-xptEo?usp=sharing]

端点

  • SSE流: GET /sse
  • 同伴POST: POST /sse/messages (JSON-RPC)

工具

  • describe_dataset –总结字段、类型、单位和源链接。
  • query_data –筛选条件 province, city, sector, naics;支持 limit ≤ 1000.
  • get_metadata –发布信息、许可证、供应商样本、官方链接。
  • get_download_links –官方目录页面和本地数据集文件路径。

快速入门(Docker)

  • 拉动: docker pull samrat156/mcpserver:latest
  • 运行: docker run --name mcpserver -d -p 3100:3100 -e PORT=3100 samrat156/mcpserver:latest
  • 测试SSE:打开 http://localhost:3100/sse
  • 发送请求: POST http://localhost:3100/sse/messages 使用JSON-RPC(例如。, tools/list).

VS代码集成(MCP)

  • 创建 .vscode/mcp.json 条目: { “服务器”:[{ “名称”:“lode odbus mcp”, “类型”:“sse”, “url”:“http://localhost:3100/sse", “messagesUrl”:http://localhost:3100/sse/messages" }] }

挑战笔记(48小时:“加拿大统计局LODE数据集的MCP”)

  • 传输方式:HTTP+SSE;匿名,无身份验证。
  • 工具:发现(describe_dataset),查询(query_data),助手(get_metadata, get_download_links).
  • 输入已验证;过宽过滤器的友好错误;强制执行查询限制。
  • 延迟:典型返回时间约为5-10秒;更快地加热查询。
  • 占用空间最小:无跟踪、无分析、仅本地日志。

数据集和许可证

  • 使用归因于加拿大开放政府许可证的开放数据。
  • 许可证:https://open.canada.ca/en/open-government-licence-canada
  • 元数据和响应包括来源和归属(如适用)。

建筑(简介)

  • 节点/TypeScript服务器;事件的SSE流+JSON-RPC的伴随POST。
  • 捆绑本地CSV;启动时加载;返回标准化JSON。
  • 防御速率限制和输入验证;出现了用于工具的模式。

EC2部署(示例)

  • 构建图像或拉取: docker pull samrat156/mcpserver:latest
  • 在EC2上运行: docker run -d -p 3100:3100 -e PORT=3100 samrat156/mcpserver:latest
  • 在客户端中提供公共SSE URL: https://<ec2-host-or-ip>:3100/sse

备注

  • 通过Git LFS跟踪大文件;合作者应该跑 git lfs install 一次。
  • 将上面的占位符(EC2主机/IP和Google Drive链接)替换为您的实际URL。