Singapore MCP by Olano

🇸🇬 Olano 新加坡 MCP

向 Claude 或 Codex 询问有关新加坡房地产、MRT/LRT、巴士、公司、天气、经济、公共服务和官方金融参考数据的问题。

291 个只读工具 · 8 个 Agent Skills · 7 个插件 · stdio 和 Streamable HTTP

现在就试用，无需安装任何内容。 在 Telegram 上向 @OlanoSGBot 发送消息，用简单的英语提问有关新加坡的问题。 免费使用，无需 API 密钥。请参阅 在 Telegram 上试用。

由 Olano 在新加坡构建并维护——Olano 是提供应用 AI 的平台 olano.ai，以及我们的新加坡 AI 工作室 olano.sg。Singapore MCP 是工作室为本地 AI 社区提供的开源贡献，基于 MIT 许可证免费使用。

Singapore MCP 是一个独立的社区项目，与新加坡政府或任何政府机构均无关联，也未经其认可，并非其官方产品。下文中的“官方”指的是上游数据来源，而非本软件。

概览

Singapore MCP 是 AI 客户端与新加坡官方公共数据之间的只读桥接服务，数据来源包括 data.gov.sg、OneMap、LTA DataMall 和 SingStat。每个回答都会保留来源机构、数据集标识符、观测期、单位和数据时效说明，方便你核查。大部分功能完全无需 API 密钥。

此 monorepo 将数据源访问、可复用分析和面向用户的工作流分开。安装聚合服务即可获得完整体验；如果只需要某个数据源，也可以安装对应的专用可执行程序。

聚合、data.gov.sg、OneMap、LTA、weather 和 rail 包提供专用的 stdio/HTTP 可执行程序。其他包是可复用的注册库，由聚合服务组合使用。

示例问题

你可以在 MCP 客户端中提出以下问题，也可以使用 olano-sg examples [category] 浏览打包的提示词目录。结果取决于上游数据覆盖情况；对于少数工具，还取决于凭据与缓存中提到的可选密钥。还没安装？不妨先在 Telegram 上通过 @OlanoSGBot 试问几个问题，或者直接查看快速入门。

公司与 ACRA

• “查找与 Olano 匹配的官方公开 ACRA 记录，并显示 UEN 和实体状态。”
• “在所有 ACRA 分片中查询此 UEN，并明确说明任何匹配的不确定性。”
• “比较每月企业成立数和注销数，然后计算净成立数。”
• “比较两个 SSIC 行业在匹配时段内的成立数变化。”

HDB 与私人房地产

• “显示勿洛近期的 4 房 HDB 转售交易，并计算中位数和四分位数。”
• “比较淡滨尼和裕廊东的 HDB 转售单价（每平方米）。”
• “查找地址中包含 Bishan 的 HDB 停车场，并按停车场类型分组。”
• “显示项目或地区有界定范围的私人房地产交易证据。”
• “结合 OneMap 位置背景，为女皇镇制作区域房产简报。”

第一个示例是一次 MCP 操作。hdb_resale_stats 会应用准确的城镇和组屋类型筛选条件，默认选择最新的匹配月份，返回交易行，并在服务端计算范围、中位数、Q1、Q3 和每平方米价格：

npx -y @olano/sg-cli tool hdb_resale_stats '{"town":"BEDOK","flatType":"4 ROOM"}'

使用 latestMonths、startMonth 或 endMonth 选择其他时段。无需直接下载数据集。此操作适用于聚合服务的 all 和 property 配置；它不属于专用的 @olano/mcp-datagov 行读取器软件包。

COE、巴士、道路、停车与出租车

• “最新的 B 类 COE 溢价、配额、投标数和投标配额比是多少？”
• “显示最近 12 次 A 类投标，并列出与上次溢价相比的变化。”
• “下一班巴士何时抵达此巴士站？”
• “列出现有交通事故及附近的交通摄像头图像。”
• “显示 LTA 实时停车场空位情况和出租车空位情况。”

MRT 与 LRT

• “巴耶利峇的 MRT/LRT 代码和线路连接有哪些？”
• “列出汤申—东海岸线上的所有车站。”
• “哪些官方车站出口属于政府大厦站？”
• “查找距离纬度 1.29027、经度 103.851959 最近的五个轨道交通站。”
• “查找 1 Fullerton Road 附近的轨道交通站，并说明距离是直线距离还是步行距离。”
• “列出 MRT/LRT 换乘站，并显示每份打包数据源快照的日期。”

天气、PSI、降雨与登革热

• “显示新加坡各地区当前的两小时天气预报。”
• “显示各站点最新的温度和降雨读数。”
• “显示 24 小时预报、四日展望和最新 PSI 读数。”
• “查找当前登革热聚集区记录，并注明数据集的最新更新时间。”

教育与托儿服务

• “查找与 Nanyang 匹配的 MOE 学校，并显示官方数据集字段。”
• “查找某地区的 ECDA 托儿中心，并汇总已公布的空缺字段。”
• “使用 OneMap 解析此地址，然后比较附近的学校或托儿记录。”

GDP、价格、劳动力、收入、外汇、税收与贸易

• “显示最新的 GDP 增长观测值，并比较选定行业。”
• “使用相同月份而非相邻月份，计算 CPI 同比变化。”
• “比较匹配月度时段内的零售销售同比变化与 CPI。”
• “显示收入中位数历史数据、各行业就业人数，以及计算得出的就业增长。”
• “显示失业率和居民劳动力参与率历史数据。”
• “查找 MAS 官方汇率观测值，并保留各自公布的单位。”
• “显示 IRAS 税收历史数据，仅在单位匹配时计算类别占比。”
• “显示 SingStat 的新加坡商品贸易历史数据。”

旅游、人口、健康、能源、犯罪和小贩中心

• “按最新已发布时期对访客来源市场进行排名。”
• “展示旅游收入历史记录；如果精选数据集已过时，请提醒我。”
• “比较各可用时期的人口、活产、死亡、婚姻和离婚数据。”
• “展示疾病病例历史记录及其最近一次观测值；如适用，请明确警告数据已冻结。”
• “展示发电历史记录及来源机构。”
• “比较口径一致的已记录犯罪系列，不推断社区或个人风险。”
• “查找名称匹配 Maxwell 的 NEA 小贩中心，并分析已发布字段。”

抵押贷款参考利率

• “展示最新官方 SORA 和已发布的住房贷款参考利率系列。”
• “展示 24 个月的官方抵押贷款参考利率背景，并指出最新时期。”
• “按用户提供的示例利率，计算 S$600,000 抵押贷款的月供。”
• “按 2.5%、3.5% 和 4.5% 对该抵押贷款进行压力测试，并列出假设。”

这些是官方参考利率统计数据和教育用途的计算结果，并非贷款机构的实时报价、 信贷决策或个人财务建议。

跨系列分析与发现

• “将这些季度 GDP 和月度 CPI 系列对齐到年度时期，并说明汇总方法。”
• “比较两个匹配的系列，返回观测值、Pearson 相关系数和计算说明。”
• “为这些观测值创建文本迷你图和可用于绘图的数据点。”
• “哪个 Olano 工具适合回答：‘最近一次 COE 竞标有多激烈？’”
• “列出提示词类别，然后展示铁路和房产相关示例。”
• “展示 sg_cross_dataset 的兼容性记录。”

进阶：多步骤和跨机构问题

这类问题正是 8 个打包的 Agent Skills 和分析工具大显身手的地方。每个问题都涉及多个机构或多个时期，因此答案必须统一单位、匹配时期，并附上所有来源。请在已安装 Agent Skills 的客户端中提问，例如 Claude Code 插件或 Claude Desktop 扩展，Claude 会自行串联调用工具。

房产与可负担性

• “为 Queenstown 撰写一份房产简报：近期 4-room 转售中位数和四分位数、最近的 MRT 站，并分别注明步行距离和直线距离、附近的学校和托儿服务，以及按中位价格以 3.5% 利率计算的示例房贷。列出所有假设和来源。”
• “比较 Tampines、Bedok 和 Jurong East 在匹配月份的 HDB 转售单位面积价格，然后测试改用其他组屋类型后排名是否仍然成立。”
• “按最新公布的 SORA 和住房贷款参考利率，对 S$600,000 房贷进行压力测试，利率分别为 2.5%、3.5% 和 4.5%；并明确说明哪些是官方统计数据，哪些是我自行设定的示例假设。”

经济与跨序列分析

• “将季度 GDP 与月度 CPI 对齐为年度数据，解释所用的汇总方法，然后报告 Pearson 相关系数，并附上计算说明以及必须剔除的时期。”
• “比较零售销售同比与 CPI 同比，确保月份完全匹配，并标出两条序列在基期或单位上不同的月份。”
• “在可匹配的最长时间范围内，追踪收入中位数、分行业就业情况和居民劳动力参与率，并计算各行业的就业增长。”

商业与行业研究

• “查找与公司名称匹配的 ACRA 记录，核实所有 27 个分片中的 UEN，明确说明任何匹配的不确定性，然后结合对应行业的 SSIC 设立和停业数据，按匹配时期进行分析。”
• “比较两个 SSIC 行业的企业净设立数量，然后检查这种变化趋势是否与同期零售销售和访客抵达人数相符。”

出行与位置

• “为新办公室规划三个地址的比较：使用 OneMap 解析每个地址，列出步行范围内的轨道交通站，显示附近停车场的实时车位情况，并总结利弊，但不要推断数据无法支持的结论。”
• “展示最近 12 次 Category A 和 Category B COE 投标活动的溢价变化、配额、投标数和投标配额比，并说明竞争最激烈的活动是哪几次以及原因。”

数据质量与方法

• “只使用会披露来源机构和观测期的工具作答，并列出在这一限制下无法回答的问题部分。”
• “先告诉我你会用哪个 Olano 工具来回答这个问题，以及原因，然后再运行工具。”
• “重复这项分析，但这次展示你用到的每个数据集的新鲜度，并提醒我哪些数据已过时或冻结。”

在 Telegram 上试用

了解此服务功能最快的方式，就是问它一个问题。 @OlanoSGBot 是由 Olano 打造的免费 Telegram 机器人，由本仓库中的新加坡 MCP 工具提供支持。无需安装、无需 Node.js、无需 API 密钥，也无需注册其他账号，只要使用你已有的 Telegram 账号即可。

1. 打开 t.me/OlanoSGBot，或在 Telegram 中搜索 @OlanoSGBot。
2. 点击 Start。
3. 用普通英语提问。

适合在聊天窗口中提问的问题：

• “未来两小时的天气预报和最新 PSI 是什么？”
• “最新的 B 类 COE 溢价是多少？”
• “显示 Bedok 最近的四房式 HDB 转售价格。”
• “离 1 Fullerton Road 最近的 MRT 车站有哪些？”
• “01012 站的下一班巴士什么时候到？”

回答会注明数据来源机构和观测时段，与在 MCP 客户端中的表现相同。机器人会记住你的对话，因此你可以继续提问；想让它删除为你保存的记忆和对话数据时，随时发送 /forget。

该机器人是托管服务，而非本地安装程序。它以 Olano 托管的 Agent 形式运行在新加坡的一台服务上；每位用户的对话和记忆都会单独存储，并限定在其消息平台账号范围内，因此任何用户（包括任何 Agent 会话）都无法访问其他用户的数据。生成回复时，相关消息内容会发送给第三方大模型提供商处理，该提供商可能会在新加坡境外处理这些内容。发送任何敏感信息前，请阅读隐私。

如需日常使用、完整的 291 个工具套件以及八项 Agent Skills，请按照快速开始在自己的 AI 客户端中安装此服务。此方式会在你自己的机器上运行，不会向 Olano 发送任何内容。

快速开始

刚接触 MCP？MCP 服务是一个小型辅助程序，由你的 AI 应用在自己的电脑上运行，帮你查找信息。只需安装一次，之后就可以用普通英语提问。此服务在本地运行，读取新加坡官方公共数据；不需要 Olano 账号，也没有遥测或分析功能。请参阅隐私。

在表格中找到你使用的应用，只需按照对应的小节操作。默认安装会提供完整的 Olano Singapore 套件。无需选择类别，也无需 API 密钥。

**只想先看看它能不能用？**完全不必安装任何东西——在 Telegram 上向 @OlanoSGBot 发消息即可。请参阅 在 Telegram 上试用。

不确定自己使用的是哪种应用？如果你在聊天窗口中输入问题，那么你使用的是 Claude Desktop app。如果你在终端中运行 claude，或使用桌面应用中的 Code 标签页，那么你使用的是 Claude Code。Claude Code 的安装方式更好，因为它既能加载 Agent Skills，也能加载工具。

开始之前

要安装 Claude Desktop 扩展？无需预先安装任何东西。 Claude Desktop 自带 Node.js 运行时，扩展也包含了其他所有内容。直接跳到 Claude Desktop app。

其他所有方式都通过 npx 运行服务，而 npx 随 Node.js 一起提供。你需要安装 Node.js 20 或 更高版本。

1. 从 nodejs.org 下载 LTS 安装程序并运行。

2. 打开终端——macOS 上是 Terminal，Windows 上是 PowerShell——然后检查版本：

   node --version
   

你应该会看到 v20. 或更高版本，例如 v22.14.0。如果出现“command not found”或“not recognized”，请关闭终端，重新打开一个，再试一次。如果仍然失败，说明 Node.js 安装不正确。

你不需要下载此代码库、克隆任何内容，也不需要运行 npm install。npx 会在首次运行时为你获取已发布的软件包。

Claude Desktop app

本节适用于 Claude Desktop app 的 Chat 标签页。如果你使用 Code 标签页， 请改为参阅 Claude Code——在那里你还可以获得八个 Agent Skills。

方式 A — 安装扩展（推荐）

一个文件，一次点击，无需终端，也无需 Node.js。

1. 下载扩展。

   ⬇ 下载 olano-singapore.mcpb

   文件大小约为 2 MB，包含整个服务。所有已发布版本也都列在 发布页面。

2. 安装。 双击下载的文件。Claude Desktop 会打开审核对话框，显示该扩展添加的内容。选择 Install。

   如果双击没有反应，请打开 Claude Desktop，将文件拖到 Settings 窗口中，或前往 Settings → Extensions → Advanced settings → Install Extension… 并选择该文件。

   Claude Desktop 会提示此扩展未经签名。这是本项目的正常情况。

3. 将所有设置留空，然后完成安装。 四个可选输入框用于填写免费的政府 API 密钥，你可能还没有这些密钥。不填写也能正常使用，之后可以在 Settings → Extensions 中添加。

4. 提问。 无需重启。

   显示新加坡最新的两小时天气预报，并附上时间戳。

就这么简单，马上就能用。之后要更新时，重新下载该文件并覆盖安装即可。

方式 B — 让 AI Agent 帮你设置

你已经有 Claude Code、Codex、Cursor，或其他能编辑你电脑上文件的编码 Agent？粘贴以下内容，它就会完成全部设置：

Please add the Olano Singapore MCP server to my Claude Desktop configuration.

1. Open my Claude Desktop config file, creating it if it does not exist:
   - macOS:   ~/Library/Application Support/Claude/claude_desktop_config.json
   - Windows: %APPDATA%\Claude\claude_desktop_config.json
   - Linux:   ~/.config/Claude/claude_desktop_config.json
2. Inside the "mcpServers" object, add an entry named "singapore" that runs the
   command "npx" with the arguments ["-y", "@olano/mcp-singapore"]. On Windows use
   the command "cmd" with ["/c", "npx", "-y", "@olano/mcp-singapore"] instead.
3. Keep every server that is already in the file and keep the JSON valid.
4. Do not add any API keys. Show me the final file and tell me to fully quit and
   reopen Claude Desktop.

这种方式要求你的电脑上安装 Node.js。方式 A 不需要。

路线 C — 自行编辑配置文件

1. 打开设置文件。 在 Claude Desktop 中，打开 设置 → 开发者 → 编辑配置。该按钮会在文本编辑器中打开 claude_desktop_config.json，如果文件不存在，还会创建它。

   找不到该菜单？直接打开文件。

   系统	文件
   macOS	~/Library/Application Support/Claude/claude_desktop_config.json
   Windows	%APPDATA%\Claude\claude_desktop_config.json
   Linux	~/.config/Claude/claude_desktop_config.json

   在 macOS 上，设置窗口从菜单栏中的 Claude 打开，而不是从聊天窗口打开。在 Windows 上，查看系统托盘中的 Claude 图标。如果文件不存在，请创建它。

2. 粘贴配置。

   如果文件是空的或全新的，请粘贴下面的整个代码块——外层的 { 和 } 很重要：

   {
     "mcpServers": {
       "singapore": {
         "command": "npx",
         "args": ["-y", "@olano/mcp-singapore"]
       }
     }
   }
   

   如果文件已有其他服务，请保留它们，只添加 singapore 条目，并在条目之间加上逗号：

   {
     "mcpServers": {
       "some-server-you-already-had": {
         "command": "npx",
         "args": ["-y", "some-other-package"]
       },
       "singapore": {
         "command": "npx",
         "args": ["-y", "@olano/mcp-singapore"]
       }
     }
   }
   

   同一文件也可以在 examples/claude-desktop.json 中找到。

   使用 Windows？请改用此版本。

   Windows 会将 npx 安装为 .cmd 脚本，某些版本的 Claude Desktop 无法直接启动它。如果上面的普通版本报错，请用 cmd /c 包装：

   {
     "mcpServers": {
       "singapore": {
         "command": "cmd",
         "args": ["/c", "npx", "-y", "@olano/mcp-singapore"]
       }
     }
   }
   

3. 保存文件并完全重启 Claude Desktop。 仅关闭窗口是不够的。请彻底退出应用——在 macOS 上选择 Claude → 退出，或在 Windows 上右键点击托盘图标并选择 退出——然后重新打开。

4. 确认配置生效。 点击消息框旁边的 + 按钮，并在 连接器 下查看。你应该会看到列有工具的 singapore。然后提问：

   显示新加坡最新的两小时天气预报，并附上时间戳。

   首次提问时，npx 可能需要 20–30 秒下载软件包。之后就会很快。

如果没有看到 singapore，请参阅如果遇到问题。 参考详情请见 Claude Desktop。

Claude Code

本节适用于 claude 终端命令以及 Claude Desktop 应用中的 Code 选项卡。

请使用插件。它会安装完整的 MCP 服务和全部 8 个 Olano Agent Skills，这些技能会教 Claude 何时调用哪个新加坡工具，从而让回答获得更好的信息来源。它还提供了一个安全的位置，供你之后添加可选的 API 密钥。

1. 添加 Olano 市场。 在 Claude Code 提示符处输入以下内容，务必与示例完全一致，包括开头的 /：

   /plugin marketplace add olano-ai/mcp-singapore
   

   这只会注册目录，尚未安装任何内容。

2. 安装完整插件：

   /plugin install olano-singapore@olano
   

   出现提示时选择 用户范围，这样插件就能在每个项目中使用。如果摘要中显示 Run /reload-plugins to activate.，也请运行该命令；否则插件已经生效。

3. 确认并提问。 运行：

   /mcp
   

   你应该会看到 singapore 已连接。然后试试：

   按顺序列出汤申—东海岸线上的所有车站，并指出换乘站。

   首次调用时，软件包下载可能需要 20–30 秒。之后就会很快。

希望 Claude 帮你完成？

将以下内容粘贴到 Claude Code，它会为你运行安装流程并检查结果：

Install the complete Olano Singapore plugin for me. Run
`npx -y @olano/sg-cli setup claude`, verify it with
`npx -y @olano/sg-cli doctor claude`, and tell me when to start a new session.
Do not ask me for optional API keys yet.

更喜欢用一行终端命令？

这会在用户级别以非交互方式完成相同的两个步骤。你可以随时重新运行，以刷新 Olano 市场：

npx -y @olano/sg-cli setup claude
npx -y @olano/sg-cli doctor claude

之后启动新的 Claude Code 会话，或在已打开的会话中运行 /reload-plugins。

claude mcp add --transport stdio --scope user singapore -- npx -y @olano/mcp-singapore

Codex app

Codex app 和 Codex CLI 共用相同的 MCP 配置，因此只需安装一次服务。

1. 打开 Settings → MCP servers → Add server。

2. 输入 singapore 作为名称，选择 STDIO，将 npx 设为命令，并输入以下参数：

   -y @olano/mcp-singapore
   

3. 保存，选择 Restart，然后在新对话中输入 /mcp，确认 singapore 已连接。

已经通过 Codex CLI 安装过？那就无需再添加其他内容。重启 app，它就会使用相同的配置。

Codex CLI

1. 添加完整的 MCP 服务：

   codex mcp add singapore -- npx -y @olano/mcp-singapore
   

2. 确认已启用：

   codex mcp list
   

3. 启动新的 Codex 会话并运行 /mcp，然后提问。

更喜欢让 Codex 执行安装？粘贴以下提示词：

Install the complete Olano Singapore MCP for me. Run
`codex mcp add singapore -- npx -y @olano/mcp-singapore`, verify it with
`codex mcp list`, and tell me when to start a new session.
Do not request optional API keys yet.

该命令有意不带 --profile 参数。未选择配置时，@olano/mcp-singapore 会加载完整套件。

如果遇到问题

找到与您看到的情况相符的行。Node.js 相关行仅适用于 npx 方式——Claude Desktop 扩展没有这项依赖。

随时检查 Claude Code 安装的确切状态：

npx -y @olano/sg-cli doctor claude

仍然无法解决？请提交问题，并提供应用名称、操作系统、安装方式以及 node --version 的输出。

可选：选择更小的配置集

上述快速入门命令会安装所有内容。之后，经验丰富的用户可以选择更专注的配置集，减少发送给模型的工具定义。

每个配置集都有自己的 Claude Code 插件。安装方式与完整插件相同：

/plugin install olano-singapore-property@olano

或者在终端中选择配置集，--profile 会直接缩小 MCP 服务的范围：

npx -y @olano/sg-cli setup claude property
codex mcp add singapore-property -- npx -y @olano/mcp-singapore --profile property

对于 Claude Desktop，请在配置文件的 args 数组中添加 "--profile", "property"。一键扩展始终会加载完整套件；如果要在其中使用配置集，请采用配置文件方式。

可尝试的问题

• “按顺序列出汤申－东海岸线的所有车站，并指出换乘站。”
• “查找距离纬度 1.29027、经度 103.851959 最近的 MRT 或 LRT 车站。”
• “查找与 Olano 匹配的官方 ACRA 公开记录，并显示 UEN 和实体状态。”
• “显示最新的两小时天气预报和 PSI，并附上时间戳。”
• “比较时间段完全匹配的新加坡 CPI 和零售销售数据。”
• “对 S$600,000 房贷进行压力测试，分别采用 2.5%、3.5% 和 4.5% 的利率，并列出每项假设。”

更多示例请参阅示例问题，或运行：

npx -y @olano/sg-cli examples

刚开始使用？现在就停下来试着提一个问题。 本 README 其余部分介绍软件包、传输方式、凭据、数据来源和开发。

更多运行方式

运行而不保存 MCP 配置

npx -y @olano/mcp-singapore

将其添加到接受通用 mcpServers 格式的客户端：

{
  "mcpServers": {
    "singapore": {
      "command": "npx",
      "args": ["-y", "@olano/mcp-singapore"],
      "env": {
        "DATA_GOV_SG_API_KEY": "optional-data-gov-key",
        "ONEMAP_TOKEN": "your-onemap-token",
        "LTA_DATAMALL_API_KEY": "your-lta-account-key",
        "OLANO_SG_CACHE_DIR": "/absolute/path/to/olano-sg-cache"
      }
    }
  }
}

移除不使用的凭据，切勿提交真实值。服务无需任何凭据即可启动；只有需要凭据的工具才会返回缺少凭据错误。

更小的服务端工具配置集

聚合服务默认使用 all。若要减少发送给模型的工具定义，可选择专注的生产配置集，同时保留 MCP 提示词和资源：

npx -y @olano/mcp-singapore --profile mobility
OLANO_SG_PROFILE=property npx -y @olano/mcp-singapore

稳定配置集包括 mobility、property、business、economy、civic 和 finance。singapore_tool_profiles 始终可用，并会返回每个配置集的前缀约定、准确的实时工具数量，以及可选的工具名称清单。这些定义也用于 olano-sg profiles 和 olano-sg profile <name>。如果配置集名称未知，服务会在启动时失败，而不会静默回退到 all。

通过 Streamable HTTP 使用 MCP

npx -y @olano/mcp-singapore --transport http --host 127.0.0.1 --port 3000

MCP 端点为 http://127.0.0.1:3000/mcp。默认绑定地址为 localhost。向网络公开之前，请添加 TLS、身份验证、请求限制和运行监控。

专注型服务使用相同的标志：

npx -y @olano/mcp-rail-sg --transport http --port 3001
npx -y @olano/mcp-weather --transport http --port 3002

CLI

npm 软件包为 @olano/sg-cli；其可执行文件为 olano-sg。

npx -y @olano/sg-cli list
npx -y @olano/sg-cli search rail
npx -y @olano/sg-cli examples
npx -y @olano/sg-cli examples property
npx -y @olano/sg-cli ask "Compare recent HDB resale prices in Bedok"
npx -y @olano/sg-cli datasets economy
npx -y @olano/sg-cli prompts
npx -y @olano/sg-cli tool weather_two_hour_forecast '{}'
npx -y @olano/sg-cli setup claude property
npx -y @olano/sg-cli doctor claude property

ask 及其别名 query 使用确定性的本地路由器。它们会推荐工具、提取明显的参数并指出缺少的输入；不会将问题发送给外部模型，也不会静默执行推荐的操作。若要明确调用工具，请使用 tool。

有关特定客户端的参考资料、更新和验证，请参阅 Claude Desktop、Claude Code 插件和 Codex 和 OpenAI 插件。

提示词和资源

聚合服务打包了可复用的 MCP 提示词：

• research-singapore
• research-neighbourhood
• research-company
• analyze-property
• analyze-mobility

它还通过 singapore://about、singapore://sources 和 singapore://examples 提供只读资源。还可通过 singapore_prompt_categories、singapore_prompt_examples、singapore_prompt_for_tool 和 singapore_ask 使用基于工具的发现功能。

打包的 Agent Skills

此仓库包含八个可复用工作流，供支持 Agent Skills 的客户端使用：

• research-singapore — 针对地点、交通出行、经济、人口、环境和公共服务的一般研究；
• analyze-singapore-property — HDB／私人房产证据、邻里环境、交通、配套设施和教育用途的抵押贷款情景分析；
• research-singapore-business — ACRA／UEN 查询、企业设立、行业、劳动力、通胀、汇率、零售、旅游和贸易背景研究；
• analyze-singapore-mobility — MRT／LRT、巴士、道路、停车、出租车、路线规划和 COE 分析；
• analyze-singapore-economy — 按时期和单位分析经济指标；
• research-singapore-civic — 天气、健康、教育、人口、安全和公共服务研究；
• analyze-singapore-finance — 官方利率，以及透明的抵押贷款和负担能力情景分析； 以及
• develop-with-singapore-mcp — 配置文件选择、精确的工具调用、凭据、传输方式和故障排除。

安装和使用指南请参阅 skills/README.md。

凭据和缓存

每个提供方都使用内存中的 TTL 缓存。设置 OLANO_SG_CACHE_DIR 后，还会在不同进程之间持久化符合条件的公开响应。缓存条目使用提供方专属 TTL 和哈希键，按请求头身份的哈希值分区，并且不会在存储的来源元数据中保留整个查询字符串。不过，响应负载仍可能包含地址、公司搜索或其他请求结果。请勿让不可信租户共用同一缓存目录；应将其作为应用数据加以保护，并在保留要求规定时清除。singapore_cache_info 会报告缓存是否已启用。

官方上游来源与署名

只要上游格式允许，本套件都会保留来源机构、数据集／表格标识符、来源 URL、检索时间、观测周期、单位及数据时效性说明。

• data.gov.sg 开发者指南 — 新加坡各机构发布的公共数据集，包括精选目录使用的 ACRA、HDB、URA、MOE、ECDA、IRAS、STB、EMA、SPF、MOH 和 NEA 数据集。
• OneMap API 文档 — 新加坡土地管理局提供的地址、地理编码和路线规划服务。
• LTA DataMall — 陆路交通管理局提供的动态交通 API 和可下载的铁路数据集。
• SingStat Table Builder — 新加坡统计局提供的经济、商业、劳动力、贸易和人口统计表。
• 新加坡气象服务 — 官方天气信息；已实现的实时数据流通过 data.gov.sg 检索。
• 官方银行利率数据集 — 由 SingStat 发布、数据来源为新加坡金融管理局的统计序列，包括 SORA 和已发布的银行利率统计数据。
• 新加坡开放数据许可 — 适用于受其涵盖的 data.gov.sg 材料的许可。

铁路工具还会通过 rail_source_metadata 披露 LTA 快照的确切日期和来源 URL。API 可用性、数据准确性、速率限制、许可和上游条款仍由相应提供方控制。应用必须遵守这些条款并保留规定的署名信息。

金融数据范围

Olano 仅集成上述免费的官方抵押贷款参考利率数据集。由于尚未验证存在稳定、免费的官方 API，且其生产和再分发条款适用，因此不会提供实时 SGX 报价、贷款机构产品报价或保险费。它不会抓取比价网站，也不会将第三方报价数据标记为新加坡官方数据。请使用 finance_singapore_data_availability 查看当前范围和官方参考链接。

安全与工程

这些服务均为只读。输入由 Zod 验证；上游来源和路径在代码中固定；请求使用超时、响应大小限制、重试、请求间隔控制和缓存；工具在缺少凭证时会返回明确错误。派生工具会说明假设，不会将区域、公司、犯罪、房产或金融数据转化为缺乏依据的个人结论。

开发

需要 Node.js 20 或更高版本。

npm install
npm run format:check
npm run lint
npm test
npm run build

交互式检查聚合服务：

npx @modelcontextprotocol/inspector node packages/singapore/dist/cli.js

构建并验证 Claude Desktop 安装包。check:mcpb 会在仓库外解包已打包的 .mcpb，并使用其自身清单声明的确切命令启动它，因此，如果某个依赖只能通过单体仓库解析，此处就会报错，而不会等到用户的机器上才出问题：

npm run build:mcpb
npm run check:mcpb

参阅架构、Claude Desktop、贡献指南和安全。

许可证

源代码依据 MIT 许可证发布。政府数据仍受各来源机构发布的许可证和条款约束。