datasaudi-mcp

Name: datasaudi-mcp
Author: mohsinmshabbir

本地服务

github.com/mohsinmshabbir法律与政务116 周前更新

代码仓库

关于 datasaudi-mcp

datasaudi-mcp 让 MCP 客户端以英语或阿拉伯语查询 DataSaudi 的沙特官方经济与社会统计数据。它可搜索 277 个 GASTAT 数据集并实时获取结果，无需 API 密钥或本地数据库。

主要功能

01以英语或阿拉伯语搜索 277 个数据集
02查看数据集维度和指标
03执行经过验证且支持分页的查询
04从 DataSaudi 实时获取数据
05阿拉伯语查询返回阿拉伯语标签

适用场景

01比较各地区通胀和 CPI 数据
02按贸易伙伴和流向查看贸易数据
03按省份及人口特征分析人口
04追踪房地产价格指数趋势

MCP 相关

向 MCP 客户端提供数据集搜索、数据集说明和查询工具，模型可据此选择并查询数据集。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "mohsinmshabbir-datasaudi": {
      "command": "uvx",
      "args": [
        "datasaudi-mcp"
      ]
    }
  }
}

启动命令uvx datasaudi-mcp

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

pypidatasaudi-mcp0.1.0stdio

工具

收录的工具列表 · 更新于 2 周前

参数	类型	必填
query	string	否
scope	string	否
locale	string	否
offset	integer	否

详细介绍

datasaudi-mcp

向 Claude、Cursor 或任何 MCP 客户端咨询沙特经济—— 使用通俗英语 或阿拉伯语。无需 API 密钥，也无需数据库。

随便提问 · 涵盖内容 · 安装 · العربية · 工具

GDP、通货膨胀、贸易、人口、房地产价格指数——来自 DataSaudi 的 277 个官方 GASTAT 数据集，可在你的 AI 客户端中直接获取并作答。你无需指定数据集，模型会自动找到它。

以下是在 Claude Desktop 中的使用效果——只需用通俗英语提问，模型便会找到数据集，提取利雅得房地产价格指数并与全国趋势对比，然后绘制图表：

datasaudi-mcp 在 Claude Desktop 中回答问题

随便提问

约 2 分钟即可连接（安装），然后直接提问：

💬 "利雅得的房地产价格指数各季度分别是多少？与全国趋势相比如何？"

💬 "沙特阿拉伯的主要贸易伙伴有哪些？请按国家以及出口和进口拆分对外贸易。"

🇸🇦 "اعرض الرقم القياسي لأسعار العقارات في الرياض حسب الربع" — 用阿拉伯语提问，即可获得阿拉伯语回答（الرياض、مكة المكرمة）。请参阅阿拉伯语支持。

模型会找到合适的数据集，提取数据并作答。你无需了解任何数据集名称或查询语法。

更多提示词示例

"展示最新一年的各省通货膨胀率和 CPI——哪些地区最高？"
"别墅和公寓的房地产价格指数随时间有何差异？"
"按性别和国籍（沙特与非沙特）拆分各省人口，分别是多少？"
"展示各经济部门的实际 GDP，按季度比较，并附上同比增长率。"
"比较平均月工资：沙特人与非沙特人、男性与女性分别如何？"

可以询问的内容

277 个精选的 GASTAT / DataSaudi 数据集。每次查询都会调用实时 API，因此数据会随 GASTAT 发布而更新。

📈 经济

GDP（行业 / 支出 / 活动）、CPI 和通胀（全国及各省）、生产者价格指数、FDI、对外贸易（国家 / 产品 / 流向）、贸易差额、商业和消费者信心。

👥 社会

人口（省 / 性别 / 国籍 / 年龄）、家庭和住宅、工资、就业率和参与率、教育、健康、残障。

🏗️ 房地产

按省份和房产类型（别墅 / 公寓 / 土地）划分的价格指数、建筑许可证、建筑成本指数、住房产权和类型。

🌍 更多

旅游和酒店入住率、能源和水资源、朝觐和副朝、SAMA 金融序列、国际报告指标（世界银行 / 联合国）。

重要

刻意设定的边界。 值得信赖的数据工具会明确说明自身的边界。

提供房地产价格指数（基准年为 100）——不提供以里亚尔计价的单笔交易价格（这些数据由 MoJ / Srem 提供）。

不包含 MoJ 交易量、REGA、市政 / ZATCA / CMA 数据或微观数据。这是约 277 个系列的核心指标层，而非完整的国家数据集。

对大多数系列，地理粒度仅到省级——不提供城市 / 区域细分。

如果询问的内容超出范围，服务会明确说明，而不是猜测。

安装

无需 API 密钥，也无需配置——DataSaudi 不需要密钥。你需要先安装 uv。

Claude Code — 一行命令，无需编辑文件：

claude mcp add datasaudi -- uvx datasaudi-mcp

Claude Desktop

打开 Settings → Developer → Edit Config，添加以下代码块，然后完全退出并重新打开 Claude Desktop（从系统托盘中完全退出，而不只是关闭窗口）：

{
  "mcpServers": {
    "datasaudi": {
      "command": "uvx",
      "args": ["datasaudi-mcp"]
    }
  }
}

Cursor

打开 Settings → Tools & MCP → New MCP Server（或编辑 ~/.cursor/mcp.json），添加相同代码块：

{
  "mcpServers": {
    "datasaudi": {
      "command": "uvx",
      "args": ["datasaudi-mcp"]
    }
  }
}

然后提出上面列出的任一问题。

阿拉伯语支持

将阿拉伯语沙特数据作为核心功能提供，而非事后补充。

用阿拉伯语提问，获取阿拉伯语回答。 成员名称会以阿拉伯文字返回：利雅得为 الرياض，麦加为 مكة المكرمة，东部省为 المنطقة الشرقية。
目录搜索也支持阿拉伯语——阿拉伯语词语可以匹配数据集的阿拉伯语主题 / 来源注释。
不同语言的数字和结构完全相同——只有便于阅读的说明文字会改变。

这些工具

三个工具负责完成工作，由模型为你调用。

工具	功能
`list_cubes`	按关键词（英语或阿拉伯语）搜索包含 277 个数据集的目录。
`describe_cube`	显示某个数据集的细分维度和指标。
`query_cube`	执行经过验证的查询并返回整洁的数据行，同时回显查询内容并准确处理分页。

故障排除 — 找不到“datasaudi”

是否完全退出并重新打开了应用？（仅关闭窗口还不够——请从系统托盘退出。）
配置是否为有效的 JSON？多余的逗号会导致整个文件失效——请将其粘贴到 JSON 验证器中。
是否已安装 uv，并且它位于 PATH 中？请在终端运行 uvx --version。
请检查客户端的 MCP / 工具面板，查看 datasaudi 旁是否有错误消息。

数据来源与时效性

数据实时来自 api.datasaudi.sa（由经济与规划部运营的 DataSaudi Tesseract API；数据由 GASTAT 提供）。服务不保存本地副本 ——每次查询都会获取最新数据，因此结果始终与 DataSaudi 本身一样及时。会话期间仅在内存中缓存轻量级的数据集目录。

DataSaudi 的数据使用条款由其运营方制定；本项目是独立的开源客户端，并注明 GASTAT / MEP 为数据来源。请根据你的使用场景查阅 DataSaudi 的条款。

贡献

欢迎贡献——请参阅 CONTRIBUTING.md。如需在本地开发：

git clone https://github.com/mohsinmshabbir/datasaudi-mcp
cd datasaudi-mcp
uv sync --all-extras
uv run pytest -m "not live"    # offline test suite
uv run pytest -m live          # optional: hits the real API