Sdmx mcp nut公共门户
SDMX-MCP-NG项目的接入网关
______________________________________________________________________
🏆 黑客马拉松参与者 🏆
欢迎来到国家黑客马拉松2025！
🚀 尝试聊天界面
我们建立了一个 对话式AI聊天界面 它允许您使用自然语言查询873个卢森堡统计数据流！
👉 YaSchat-聊天界面 👈
快速开始:
你能做什么:
- 💬 在中提问 多种语言：英语、德语（德语）、法语（法语）、卢森堡语（Lëtzebuergesch）等等！
- 📊 在3-8秒内获取真实的SDMX数据
- 🔍 发现873卢森堡数据流
- 📈 分析就业、GDP、价格、人口数据
查询示例:
- 🇬🇧 “获取2024年的失业统计数据”
- 🇩🇪 “告诉我2024年的失业数据”
- 🇫🇷 “给我2024年的失业统计数据”
- 🇱🇺 “2024年的失业率”
系统状态: ✅ 所有服务均已准备就绪！
______________________________________________________________________
🚀 快速入门：部署平台
本指南提供了使SDMX-MCP-NG平台运行的最快方法。
步骤1：访问私有存储库
主源代码位于私有存储库中。必须先授予您访问权限，然后才能部署/使用该平台。
- ➡️ 单击此处填写项目访问请求表
- 等待批准（通常为1-3个工作日），并接受您通过电子邮件收到的GitHub邀请。
步骤2：克隆此公共门户
将此存储库克隆到本地计算机以获取部署脚本。
git clone https://github.com/sdmx-mcp-ng-orga/sdmx-mcp-ng-public-portal.git
cd sdmx-mcp-ng-public-portal步骤3：运行安装脚本
一旦您被授予访问权限，请运行setup命令。此脚本将检查您的权限并克隆私有 sdmx-mcp-ng 存储库为您服务。
# Make the script executable
chmod +x deploy-public-portal.sh
# Run the setup
./deploy-public-portal.sh setup私有存储库将被克隆到一个新的 sdmx-mcp-ng 目录。
步骤4：配置API密钥
该平台需要LLM提供商的API密钥（如Gemini、Claude或OpenAI）。
- 导航到私有存储库：
cd sdmx-mcp-ng - 创建一个
.env文件：cp .env.example .env - 编辑
.env文件(nano .env)并添加您的PLANNER_LLM_API_KEY并设置安全NEO4J_PASSWORD.
步骤5：部署平台
现在，您可以使用部署脚本启动所有服务。
# From the sdmx-mcp-ng-public-portal directory
./deploy-public-portal.sh dev此命令在开发模式下启动整个堆栈（数据库、应用程序、监控）。
管理环境
使用包装器脚本来管理您的部署：
- 停止所有服务：
./deploy-public-portal.sh down - 检查服务状态：
./deploy-public-portal.sh status - 查看日志：
./deploy-public-portal.sh logs - 检查健康状况：
./deploy-public-portal.sh health
______________________________________________________________________
📦 什么是SDMX-MCP-NG？
先进的， AI驱动平台 用于与 SDMX （统计数据和元数据交换）数据。
主要特点
- 🗄️ Neo4j图形数据库 -高效的元数据存储和查询。未来可以考虑使用GraphQL驱动的架构
- 🤖 AI驱动的查询 -使用LLMs实现Cypher的自然语言
- 🔌 MCP协议 -与AI助手的标准集成
- 🚀 快速演示设置 -预填充备份/金色映像，便于快速启动
- 🌍 多源支持 -国家统计机构、欧洲央行和其他SDMX提供商
技术栈
- 数据库： 带APOC的Neo4j 5.21
- 后端： Python 3.10+与FastMCP
- 协议： 模型上下文协议（MCP）
- AI/LLM： Google Gemini、Anthropic、Claude、OpenAI、Mistral、自定义
- 部署： Docker&Docker编写
______________________________________________________________________
📚 文档
授予访问权限后，可以在私有存储库中获得完整的文档。
访问后可用：
- 安装和设置指南
- 架构文档
- API 参考
- 配置指南
- 演示教程
______________________________________________________________________
🤝 访问级别
读卡器（默认）
- ✅ 克隆并拉取存储库
- ✅ 查看代码和文档
- ✅ 创建并评论问题
- ❌ 推送代码
编剧（应要求）
- ✅ 所有阅读器权限
- ✅ 推送到分支机构
- ✅ 创建拉取请求
*大多数用户收到 读者 访问*
______________________________________________________________________
💬 联系与支持
- 访问请求： 使用问题模板
- 问题：
- 响应时间： 1-3个工作日
______________________________________________________________________
❓ 常见问题解答
Q： 这是开源的吗？ A： 是的，在未来，与此同时，私有存储库目前具有受控访问权限，以改进（sdmx图-db模式映射、LLM代理架构、加速部署过程的金色映像…）。
Q： 批准需要多长时间？ A： 通常为1-2个工作日。
Q： 我可以重新分发代码吗？ A： 不，其他人必须请求自己的访问权限。
Q： 有成本吗？ A： 不，合法用例（研究、开发、评估）可以免费访问。
______________________________________________________________________
📜 许可证
私有存储库中的代码有自己的许可证，在授予访问权限后即可使用。此公共门户存储库遵循MIT许可证。
______________________________________________________________________
🔒 私有存储库-需要访问
*由@hdjebar维护*