内容
<!-- mcp-name: io.github.mohsinmshabbir/datasaudi-mcp -->
<div align="center">
# 数据音频MCP
*询问 Claude、Cursor 或任何 MCP 客户端关于沙特经济的问题*
*使用纯英语 **或阿拉伯语**。无需 API 密钥，无需数据库。*
[](https://pypi.org/project/datasaudi-mcp/)
[](https://registry.modelcontextprotocol.io/v0/servers?search=datasaudi)
[](LICENSE)
[](https://www.python.org/)
[](https://github.com/mohsinmshabbir/datasaudi-mcp/actions)
<br/>
**[询问](#询问)** · **[覆盖范围](#您可以询问的内容)** · **[安装](#安装)** · **[阿拉伯语支持](#阿拉伯语支持)** · **[工具](#工具)**
</div>
---
国内生产总值、通货膨胀率、贸易、人口、房地产价格指数 — **277个官方GASTAT数据集**，来自[DataSaudi](https://datasaudi.sa)的实时数据，在您的AI客户端中直接回答。您无需指定数据集名称；模型会自动找到它。
以下是 Claude Desktop 中的示例：只需一个纯英语问题，模型就会找到数据集，拉取利雅得的房地产价格指数与全国趋势进行比较，并绘制图表：
---
## 询问
连接大约需要 2 分钟（[安装](#安装)），然后直接询问：
> 💬 *"请问房地产价格指数在利雅得按季度是多少？它与全国趋势相比如何？"*
> 💬 *"沙特阿拉伯的主要贸易伙伴是谁？请按国家和出口与进口划分对外贸易情况。"*
> 🇸🇦 *"اعرض الرقم القياسي لأسعار العقارات في الرياض حسب الربع"*
> — 用阿拉伯语提问，获得阿拉伯语回答（`الرياض`，`مكة المكرمة`）。参见[阿拉伯语支持](#阿拉伯语支持)。
模型会发现正确的数据集，拉取数据并回答。**您不需要知道任何数据集名称或查询语法。**
<details>
<summary><b>更多示例问题</b></summary>
<br/>
- *"请显示最新年份各省份的通货膨胀率和消费者价格指数（CPI）- 哪些地区的数字最高？"*
- *"房地产价格指数在别墅和公寓之间随着时间推移有何不同？"*
- *"按省份、性别和国籍（沙特 vs. 非沙特）划分的人口是多少？"*
- *"请显示按经济部门划分的季度环比和同比增长率的实际GDP。"*
- *"比较平均月薪：沙特 vs. 非沙特，男性 vs. 女性。"*
</details>
---
## 您可以询问的内容
277个精选的GASTAT / DataSaudi数据集。每个查询都会调用**实时**API，因此数据与GASTAT发布的最新数据保持一致。
<table>
<tr>
<td width="50%" valign="top">
**📈 经济**
国内生产总值（部门/支出/活动）、CPI和通货膨胀率（全国+按省份）、生产者价格指数、FDI、对外贸易（国家/产品/流量）、贸易平衡、商业和消费者信心。
</td>
<td width="50%" valign="top">
**👥 社会**
人口（省份/性别/国籍/年龄）、家庭和住宅、工资、就业和参与率、教育、健康、残疾。
</td>
</tr>
<tr>
<td width="50%" valign="top">
**🏗️ 房地产**
按省份和房产类型划分的**价格指数**（别墅/公寓/土地）、建筑许可、建筑成本指数、住房产权和类型。
</td>
<td width="50%" valign="top">
**🌍 更多**
旅游和酒店入住率、能源和水资源、哈吉和乌姆拉、SAMA金融系列、国际报告（世界银行/联合国）指标。
</td>
</tr>
</table>
> [!IMPORTANT]
> **它在有意为之的限制。** 一个值得信赖的数据工具会告诉你它的边界。
> - 提供**价格指数**（基准年100）— **不是按里亚尔计算的每笔交易价格**（这些数据在MoJ / Srem中实时更新）。
> - 无MoJ交易量，无REGA，无市政/ZATCA/CMA数据，无微观数据。这是约277系列的**头条指标**层，而不是整个国家语料库。
> - 大多数序列的地理细节仅限于**省份**级别 — 无城市/地区细分。
>
> 如果您询问的内容在此范围之外，服务器会如实告知，而不是进行猜测。
---
## 安装
无需API密钥，无需配置 — DataSaudi 是无密钥的。您需要安装[`uv`](https://docs.astral.sh/uv/getting-started/installation/)。
**Claude 代码** — 一行命令，无需编辑文件：
```bash
claude mcp add datasaudi -- uvx datasaudi-mcp
```
<details>
<summary><b>Claude Desktop</b></summary>
<br/>
`设置 → 开发者 → 编辑配置`，添加以下块，然后**完全退出并重新打开**Claude Desktop（完全退出托盘，而不是关闭窗口）：
```json
{
"mcpServers": {
"datasaudi": {
"command": "uvx",
"args": ["datasaudi-mcp"]
}
}
}
```
</details>
<details>
<summary><b>Cursor</b></summary>
<br/>
`设置 → 工具与MCP → 新建MCP服务器`（或编辑`~/.cursor/mcp.json`），使用相同的块：
```json
{
"mcpServers": {
"datasaudi": {
"command": "uvx",
"args": ["datasaudi-mcp"]
}
}
}
```
</details>
然后询问上述问题之一。
---
## 阿拉伯语支持
沙特数据支持阿拉伯语，作为一项主要功能 — 而不是事后补充。
- **用阿拉伯语提问，获得阿拉伯语回答。** 成员名称以阿拉伯语文字返回：`الرياض`代表利雅得，`مكة المكرمة`代表麦加，`المنطقة الشرقية`代表东部地区。
- **目录搜索也支持阿拉伯语** — 阿拉伯语术语与数据集的阿拉伯语主题/来源注释相匹配。
- **数字和结构在不同语言中保持一致** — 只有人类可读的标题发生变化。
---
## 工具
三个工具完成了这项工作；模型为您调用它们。
| 工具 | 功能 |
|---|---|
| `list_cubes` | 按关键词（英语或阿拉伯语）搜索277个数据集的目录。 |
| `describe_cube` | 显示单个数据集的分解维度。 |
| `query_cube` | 运行验证过的查询并返回整齐的行 — 查询回显且分页诚实。 |
<details>
<summary><b>故障排除 — "datasaudi" 未显示</b></summary>
<br/>
- 您是否**完全退出并重新打开**了应用程序？（关闭窗口是不够的 — 需要从托盘退出。）
- 您的配置是否为有效的JSON？一个不小心放置的逗号会破坏整个文件 — 请将其粘贴到JSON验证器中。
- `uv`是否已安装并在您的PATH中？在终端中运行`uvx --version`。
- 在客户端的MCP/工具面板中检查`datasaudi`旁边的错误消息。
</details>
<details>
<summary><b>数据源和新鲜度</b></summary>
<br/>
数据来自`api.datasaudi.sa`（DataSaudi Tesseract API，由经济和规划部运营；数据由GASTAT生成）。服务器**不持有本地副本** — 每个查询都是实时获取的，因此结果始终与DataSaudi本身保持最新。仅在内存中为会话缓存轻量级数据集**目录**。
DataSaudi的数据使用条款由其运营商设定；本项目是一个独立的开源客户端，并注明GASTAT / MEP为数据源。请查看DataSaudi的条款以适用于您的使用场景。
</details>
---
## 贡献
欢迎贡献 — 请参阅[`CONTRIBUTING.md`](CONTRIBUTING.md)。在本地开发：
```bash
git clone https://github.com/mohsinmshabbir/datasaudi-mcp
cd datasaudi-mcp
uv sync --all-extras
uv run pytest -m "not live" # 离线测试套件
uv run pytest -m live # 可选：调用真实API
```
## 许可证
MIT — 请参阅 [LICENSE](LICENSE)。
