🇲🇰 mk数据mcp
弥合人工智能代理与马其顿公共数据之间的差距
这 马其顿公共数据MCP服务器 是马其顿政府官方机构API的标准化数据包装器。它允许AI模型（如Claude、GPT和Gemini）通过提供 实时、权威访问 通过公共记录 模型上下文协议（MCP）.
______________________________________________________________________
🎯 愿景与使命
该项目的目标是为马其顿公共数据提供一个通用的标准化接口。通过将这些数据集作为MCP工具公开，任何AI代理或客户端都可以轻松查询和使用它们，从而实现：
- 数据科学家： 访问干净、结构化的数据集进行分析和可视化。
- 记者和学生： 对马其顿的趋势进行事实核查和分析。
- 公民： 无需浏览复杂的政府门户网站即可轻松访问公共信息。
- 公共行政： 支持循证决策。
______________________________________________________________________
🚀 核心功能
- 自然语言查询： 用户可以提出以下问题 _“过去10年的失业率是多少？”_ AI将使用正确的工具来获取答案。
- 数据集发现： 搜索和浏览来自多个官方来源的数据集。
- 数据标准化： 各种源格式（CSV、XLS、多维JSON）被转换为统一的平面JSON模式。
- 来源归因： 响应始终包含原始源URL和元数据，以确保透明度。
- 远程传输： 针对使用HTTP/SSE传输的无服务器环境进行了优化。
______________________________________________________________________
📊 主要数据源
该服务器与已建立的政府存储库集成：
- MakStat（国家统计局）: 人口、人口统计和经济统计的权威来源。
- data.gov.mk（国家开放数据门户）: 一个分散的存储库，用于存储卫生、教育、交通等领域的政府数据集。
- \[未来整合\]： 计划支持开放金融、Sobraine（议会）的立法数据和市政门户网站。
______________________________________________________________________
🏗️ 系统架构
建立在 远程MCP服务器 该项目利用现代web技术实现可扩展性和性能。
技术栈：
- 框架： Next.js 16（应用路由器）
- 语言： TypeScript（严格模式）
- SDK：
@modelcontextprotocol/sdk - 运输： HTTP/服务器发送事件（SSE）
- 造型： 顺风CSS 4和Shadcn/UI
- 部署： 针对Vercel（无服务器）进行了优化
请求管道：
- 工具调用： 客户端触发工具（例如。，
get_makstat_demographics). - 上游请求： 服务器从官方政府API获取实时数据。
- 标准化： 原始数据被处理成标准化的JSON格式。
- 答复： 干净的结果返回给AI客户端。
______________________________________________________________________
🛠️ 可用工具
| 工具名称 | 描述 | 状态 |
|---|---|---|
multiply | 用于测试的实用工具（将两个数字相乘）。 | ✅ 稳定 |
get_mak_stat | （计划）从MakStat获取统计表。 | 🚧 进行中 |
search_data_gov | （计划）在开放数据门户上搜索数据集。 | 🚧 进行中 |
______________________________________________________________________
🚦 入门指南
本地开发
- 克隆存储库：
git clone https://github.com/stefantrajanov/mk-data-mcp.git
cd mk-data-mcp- 安装依赖项：
npm install
# or
bun install- 运行开发服务器：
npm run dev
# or
bun dev- 访问MCP端点：
服务器正在监听 http://localhost:3000/api/mcp.
部署
该项目旨在部署到 维塞尔 零配置。它使用Next.js Edge Runtime进行高性能、无状态执行。
______________________________________________________________________
📡 连接到您的AI客户端
要在首选MCP客户端（如Claude Desktop或Cursor）中使用此服务器，请将客户端指向SSE端点：
"mcpServers": {
"mk-data-mcp": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://mk-data-mcp.vercel.app/api/mcp/mcp"]
}
},对于本地测试，请使用： http://localhost:3000/api/mcp/mcp
______________________________________________________________________
✨ 设计原则
该项目的UI/UX（用于未来的仪表板/可视化）如下：
- 排版： Inter（现代无衬线字体），可读性高。
- 美学： 高对比度的石板文本、微妙的渐变和反应式微动画。
- 互操作性： 与官方MCP SDK和现代AI接口完全兼容。
______________________________________________________________________
📄 许可证
该项目根据MIT许可证获得许可。请参阅 许可证 文件以获取详细信息。