柏林开放数据MCP
一组MCP（模型上下文协议）服务器和工具，用于与柏林的开放数据生态系统协同工作。
结构
此存储库包含多个组件：
/berlin-open-data-mcp
MCP服务器，用于自然语言发现和获取柏林的开放数据集。连接到柏林开放数据门户（daten.Berlin.de）并启用：
- 具有智能查询扩展的自然语言数据集搜索
- 大型数据集的智能采样数据获取
- 格式支持：CSV、JSON、Excel（XLS/XLSX）、GeoJSON、KML和WFS
- GeoJSON坐标转换（EPSG:25833→ WGS84）
- ZIP存档检测（提供直接下载URL）
- JavaScript渲染下载的浏览器自动化
看 柏林开放数据mcp/README.md 了解详情。
/datawrapper-mcp
MCP服务器，用于使用Datawrapper API创建数据可视化。通过对话式AI从柏林开放数据中自动创建图表：
- 条形图（垂直/水平）
- 折线图（单系列和多系列）
- 地图（具有自动柏林边界的GeoJSON可视化）
- 标题、标签和坐标轴的智能默认值
- 使用源数据集链接进行来源跟踪
看 数据包装器mcp/README.md 用于设置和API令牌配置。
/masterportal-mcp
用于生成就绪主机的MCP服务器 主门户 地理数据门户。从GeoJSON或WFS数据创建完整的zip包：
- 多层支持，可配置样式
- 地图配置（标题、中心、缩放、底图）
- 完整的Masterportal v3运行时捆绑
- 下载为zip，解压缩到任何web服务器
看 主门户mcp/README.md 了解详情。
/interface-prototype
基于网络的聊天界面，通过自然语言探索柏林的开放数据。将柏林开放数据MCP服务器与基于Mistral的聊天界面集成，以实现：
- 对话式数据集搜索和发现
- 数据提取和预览
- 通过沙盒JavaScript代码执行进行准确的数据分析
- 通过WebSocket实时流式传输响应
看 接口原型/README.md 用于设置和使用。
使用MCP服务器
MCP服务器是独立部署的，可以以多种方式使用：
部署服务
| 服务 | URL | 描述 |
|---|---|---|
| 柏林开放数据MCPhttps://berlin-open-data-mcp.onrender.com/mcp | 数据集搜索和获取 | |
| 数据包装器MCP | https://datawrapper-mcp.onrender.com/mcp | 图表创建 |
| 主门户MCP | 未计划 | Geodata门户生成 |
| 聊天界面 | 未计划 | 结合所有MCP的Web UI |
开始--设置
要使用 开放数据MCP 和 数据包装器MCP 代理商，您至少需要：
- 访问聊天平台 （例如，Le Chat、ChatGPT、Claude）。
- 互联网连接 （用于远程访问）。
Mistral Le Chat
连接来源 在线聊天 使用自定义MCP连接器：
要求： Le Chat Pro的Mistral帐户
- 在左侧边栏中，单击智能，然后选择连接器
- 点击+添加连接器
- 选择定制MCP连接器选项卡并填写详细信息：
1. 柏林开放数据MCP - 名称：柏林开放数据 - MCP服务器URL:https://berlin-open-data-mcp.onrender.com/mcp - 身份验证：无身份验证 1. 数据包装器MCP - 名称：数据包装器 - MCP服务器URL:https://datawrapper-mcp.onrender.com/mcp - 身份验证：无身份验证
- 点击连接节省
- 打开新聊天室，单击+那么连接器，并启用要使用的连接器
ChatGPT
- 打开配置文件菜单，然后转到设置→ Apps → 高级设置
- 启用开发者模式
- 点击创建应用程序（右上）
- 填写表格：
1. 柏林开放数据MCP - 名称：柏林开放数据 - 描述：柏林开放数据MCP - MCP服务器URL:https://berlin-open-data-mcp.onrender.com/mcp - 身份验证：无身份验证 1. 数据包装器MCP - 名称：数据包装器 - 描述：数据包装器MCP - MCP服务器URL:https://datawrapper-mcp.onrender.com/mcp - 身份验证：无身份验证
- 选中确认框，然后单击创建
- 在新聊天中，单击+→更多然后选择要使用的应用程序
❗确保为每个新会话激活MCP。
克劳德桌面版
要求：
- Claude Pro、Team或Enterprise计划（远程MCP服务器在免费层不可用）
- 互联网连接
将此添加到您的Claude Desktop配置文件中：
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - 视窗:
%APPDATA%\Claude\claude_desktop_config.json - Linux:
~/.config/Claude/claude_desktop_config.json
{
"mcpServers": {
"berlin-data": {
"command": "npx",
"args": ["mcp-remote", "https://berlin-open-data-mcp.onrender.com/mcp"]
},
"datawrapper": {
"command": "npx",
"args": ["mcp-remote", "https://datawrapper-mcp.onrender.com/mcp"]
},
}
}更新配置后重新启动Claude Desktop。
Claude.ai网站
要求：
- Claude Pro、Max、团队或企业计划
- 连接器功能访问
连接来源 Claude.ai 使用自定义连接器：
- 首选 设置 → 连接器
- 点击 添加自定义连接器 在底部
- 添加每个服务器：
柏林开放数据MCP：
| 字段 | 值 |
|---|---|
| URL | https://berlin-open-data-mcp.onrender.com/mcp |
| OAuth | 留空 |
数据包装器MCP：
| 字段 | 值 |
|---|---|
| URL | https://datawrapper-mcp.onrender.com/mcp |
| OAuth | 留空 |
- 点击 添加 节省
- 打开新聊天室，单击+，选择连接器，并启用要使用的连接器
- 当Claude要求使用工具时，单击允许（或总是允许)
🐻熊GPT
目前正在评估与BärGPT的集成
VS Code
要求：
- VS Code 安装。
- JSON文件的基本知识
添加到您的用户设置或.vscode/settings.json:
使用托管端点（无需安装）：
{
"mcpServers": {
"xxx": {
"url": "xxx",
"type": "http"
}
}
}使用本地安装：
{
"mcpServers": {
"xxx": {
"command": "npx",
"args": ["xxx"]
}
}
}有麻烦吗？--常见问题解答和故障排除
- 如何在我选择的LLM中激活MCP？
某些聊天平台（如ChatGPT）要求您 在每个新会话中重新激活MCP连接器。方法如下：
1. 开始新的聊天。 1. 点击 + （或“应用程序”/“连接器”）。 1. 启用 柏林开放数据MCP 和 数据包装器MCP 连接器。
- AI代理使用哪些数据源？
这 开放数据MCP 代理仅从以下位置访问数据集 柏林开放数据门户，其中包括2500多个关于交通、环境、人口统计和城市规划等主题的公共数据集。
这 数据包装器MCP 代理使用您提供的数据（例如，来自Open data MCP或您自己的文件）来创建可视化，它不会提取额外的外部数据。
- AI代理可以读取和分析什么样的数据集？
这 开放数据MCP 和 数据包装器MCP 代理支持多种常见的数据格式，包括：
- 表格数据： CSV、Excel（XLS/XLSX）、JSON - 地理空间数据： GeoJSON、KML、WFS（Web功能服务）层 - 结构化数据： 具有清晰列和行的API或数据集
如果数据集真的很大，代理在直接处理时可能会遇到问题，需要手动下载和上传。
- 是否可以聚合现有数据集中的值并生成新表？
对！ 这 开放数据MCP 代理可以聚合数据集中的值，如总和、平均值、计数或分组细分，并生成包含结果的新表。
- 下载和处理的文件大小或表条目是否有最大限制？
是的 开放数据MCP 代理最多可以处理数据集 1000行 或 5000个WFS功能 直接用于预览、分析或聚合。对于较大的数据集，您需要手动下载文件，并在必要时对其进行过滤或预处理，然后再上传以进行进一步分析。这一限制确保了在处理最常见的用例时快速可靠的性能。
- 地理数据集可以被分析和处理吗？
是的，代理人可以：
- 分析 GeoJSON、KML和WFS 数据（例如，学校位置、空气质量区）。 - 创建 地图或摘要 （例如，“每个地区的树木数量”）。
如果您想查看更多有用的工具，请查看此处：
- 预览GeoJSON： Geojson.io - 探索WFS层： WFS浏览器
- 下载链接不起作用。
请尝试以下步骤：
1. 检查您的互联网连接. 1. 刷新页面 或重新启动聊天工具。 1. 手动下载 数据集来自 日期：berlin.de 并将其上传到代理。
*☝🏼此外，试着问客服为什么链接不起作用。*
开放数据MCP
- 如何搜索数据集？
使用 自然语言 （例如，德语/英语）：
- *“查找潘科公共交通的数据集。”* - *“以CSV格式显示2023年的空气质量数据。”提示：* 使用以下过滤器 标签 （例如，“空气质量”）或 组织 （例如“SenUVK”）。
- 为什么代理找不到我的数据集？
可能的原因：
- 查询中的拼写错误：尝试使用更简单的术语（例如，“学校”而不是“教育机构”）。 - 数据集不是机器可读的：无法处理PDF或扫描文件。 - 门户延迟：柏林的开放数据每周同步--检查 日期：berlin.de 以获取更新。
- 我可以使用开放数据MCP分析其他城市或国家的数据吗？
不是的 开放数据MCP 仅限访问 柏林的开放数据门户对于其他地区，您需要手动上传数据。
数据包装器MCP
- 我需要做什么才能在Datawrapper中创建数据可视化？
请确保您已使用API令牌完成设置并选择了所需的权限（请参见上文）。
一旦你做到了这一点，你就可以简单地作为任何可视化目标的代理，例如“创建一个显示每个地区托儿所数量的条形图”
- 可以生成哪些类型的图形？
这 数据包装器MCP 支持：
- 条形图：带变体的水平杆（基本、堆叠、拆分） - 柱状图：带变体的垂直柱（基本、分组、堆叠） - 折线图：时间序列数据的单系列和多系列折线图 - 面积图：填充面积图 - 散布图：用于相关性分析的X/Y散点图 - 点图：带图例的水平点图 - 范围图：显示带标签端点的最小/最大范围 - 箭头图：显示两个值之间的变化方向 - 饼图和甜甜圈图：部分到整体的可视化 - 选举甜甜圈：议会式席位分布图 - 表格：格式化数据表 - 地图：GeoJSON可视化（符号图、choropleth）
*需要帮助选择吗？* 问： *“我的数据最好的图表是什么？”*
- 为什么我无法访问数据包装器？
检查这些：
1. API令牌: - 在连接器设置中输入正确吗？ - 您是否将其包含在当前聊天会话中？ 1. 权限：您的令牌需要以下权限： - chart:read, chart:write, theme:read, user:read, visualization:read 1. 帐户状态：确保您的 数据包装器帐户 是活跃的。
对初学者有用的旁证
- 什么是JSON和GeoJSON文件？
JSON （JavaScript对象表示法）是一种存储数据的简单格式。
GeoJSON 是一种使用JSON（JavaScript对象表示法）对地理数据进行编码的标准格式，使存储和共享点、线和多边形等基于位置的信息变得容易。
工具如 Geojson.io 可以帮助您在地图上预览GeoJSON文件。
- 如何打开WFS文件？
要可视化、分析或导出AI代理找到的WFS文件，请 WFS浏览器 可能对你有帮助。
- 我可以在没有编码技能的情况下使用代理吗？
试试看，这些代理是为非技术用户设计的：
1. 用简单的语言（德语/英语）提问。 1. 按照本常见问题解答中的分步指南进行操作。 1. 此外，尝试向客服寻求帮助。
局限性
为了评估各个特征的质量，我们使用我们选择的AI程序自动和手动进行了测试。以下是我们在测试过程中遇到的代理的一些局限性：
- 代理可以生成 不正确或不完整的答案，特别是当数据集太大，代理无法直接分析时。确保始终仔细检查生成的答案。
- 如果数据集太大（超过2000个条目），可能需要手动下载和上传文件，因为人工智能无法直接分析它们。
- 有时无法检索WFS特征。
- 在某些情况下，CSV数据的检索和聚合是不可能的，特别是对于大型数据集。
- 这不是MCP代理本身的限制，但当然，如果柏林开放数据门户等数据源缺乏机器可读的数据集，即使是人工智能也无法处理这些信息。这突显了提供机器可读数据的重要性。