datasaudi-mcp 是一个独立开源项目，作为 DataSaudi 的客户端，让 Claude、Cursor 以及任何支持 MCP（Model Context Protocol）的 AI 客户端能够用英语或阿拉伯语直接查询沙特阿拉伯的经济与社会统计数据。项目宗旨是“拒绝静默误导”，即数据工具应明确告知其能力边界，超出范围时直接说明而非猜测。
【用途】 该项目用于从 AI 客户端内部获取沙特官方经济与社会统计指标。用户无需知道数据集名称或查询语法，只需用自然语言提问，模型会自动发现合适的数据集、拉取数据并作答。数据来源为 DataSaudi 的 Tesseract API（由沙特经济与规划部运营，数据由 GASTAT 生产），每次查询都实时请求，因此结果与 DataSaudi 自身同步。
【主要能力】
- 覆盖 277 个精选的 GASTAT / DataSaudi 数据集，均为标题指标层。
- 经济类：GDP（按行业/支出/活动）、CPI 与通胀（全国及各省）、生产者价格指数、外商直接投资、对外贸易（按国家/产品/流向）、贸易差额、企业与消费者信心。
- 社会类：人口（按省/性别/国籍/年龄）、家庭与住房、工资、就业与参与率、教育、健康、残疾。
- 房地产类：按省和物业类型（别墅/公寓/土地）的价格指数、建筑许可、建筑成本指数、住房权属与类型。
- 其他：旅游与酒店入住率、能源与水资源、朝觐与副朝、SAMA 金融序列、国际报告指标（世界银行/联合国）。
- 阿拉伯语为一等公民特性：可用阿拉伯语提问并获得阿拉伯语回答，成员名称以阿拉伯文返回（如 الرياض 代表利雅得，مكة المكرمة 代表麦加，المنطقة الشرقية 代表东部省）；目录搜索也支持阿拉伯语术语匹配。数字与结构跨语言一致，仅人类可读标题变化。
【使用方式】
- 前置条件：需安装 uv。无需 API key，无需数据库，无需配置。
- 在 Claude Code 中可通过一行命令配置，无需编辑文件。
- 在 Claude Desktop 中：进入 Settings → Developer → Edit Config，添加配置块，然后完全退出并重新打开 Claude Desktop（需从托盘彻底退出，仅关闭窗口不够）。
- 在 Cursor 中：进入 Settings → Tools & MCP → New MCP Server，或编辑 ~/.cursor/mcp.json，添加相同配置块。
- 配置完成后即可直接提问，例如：“What was the real-estate price index in Riyadh by quarter, and how does it compare to the national trend?” 或阿拉伯语提问“اعرض الرقم القياسي لأسعار العقارات في الرياض حسب الربع”。
- 三个工具完成实际工作，由模型自动调用。
【适用场景】 适合需要快速获取沙特宏观经济与社会统计数据的分析师、研究人员、记者或开发者，在 AI 客户端内以自然语言完成数据查询与初步比较，例如比较各省通胀、分析房地产价格走势、查看人口结构或贸易伙伴排名。
【限制】
- 仅提供房地产价格指数（基年 100），不提供以里亚尔计的单笔成交价格（后者属于 MoJ / Srem）。
- 不包含 MoJ 交易量、REGA、市政 / ZATCA / CMA 数据，也不提供微观数据；这是约 277 个序列的标题指标层，而非完整国家语料库。
- 大多数序列的地理粒度止于省级，无城市/区级细分。
- 超出范围的问题服务器会明确说明，而非猜测。
【技术说明】 数据实时来自 api.datasaudi.sa（DataSaudi Tesseract API），服务器不保存本地副本，每次查询实时获取；仅在内存中缓存轻量级数据集目录以供会话使用。项目采用 MIT 许可证，欢迎贡献（见 CONTRIBUTING.md）。DataSaudi 的数据使用条款由其运营方设定，本项目为独立开源客户端，并注明 GASTAT / MEP 为数据来源。
【排错提示】 若无法使用，可检查：是否完全退出并重开应用（仅关窗口不够）；配置是否为合法 JSON（多余逗号会破坏文件，可用 JSON 验证器检查）；uv 是否已安装并在 PATH 中（终端运行 uvx --version）；查看客户端 MCP / 工具面板中 datasaudi 旁的错误信息。
