返回 MCP 目录
public公开dns本地运行

gahmen-mcp

一个用于访问新加坡data.gov.sg政府数据集的MCP服务器,提供数据集浏览、搜索和下载功能,内置API速率限制。

article

README

🚀 新加坡政府MCP服务器

本MCP(模型上下文协议)服务器专为新加坡data.gov.sg的API设计,可让用户轻松访问政府数据集和集合。

✨ 主要特性

  • 可访问data.gov.sg的集合和数据集。
  • 能够使用CKAN数据存储API在数据集中进行搜索。
  • 具备数据集下载功能,并支持过滤。
  • 内置速率限制,以遵守API配额(每分钟最多5个请求)。

🛠️ 可用工具

集合

  • list_collections - 列出data.gov.sg上的所有集合。
  • get_collection - 获取特定集合的元数据。

数据集

  • list_datasets - 列出data.gov.sg上的所有数据集。
  • get_dataset_metadata - 获取特定数据集的元数据。
  • search_dataset - 使用CKAN数据存储在数据集中搜索数据。
  • initiate_download - 开始下载数据集,并可选择进行过滤。
  • poll_download - 检查下载状态并获取下载URL。

📦 安装指南

npm install

💻 使用示例

基础用法

// 搜索人口数据
search_dataset({
  resource_id: "d_8b84c4ee58e3cfc0ece0d773c8ca6abc",
  q: { "year": "2023" },
  limit: 10
})

高级用法

// 获取集合522及其所有数据集的元数据
get_collection({
  collectionId: "522",
  withDatasetMetadata: true
})

🔧 技术细节

API速率限制

服务器实现了自动速率限制:

  • 每分钟最多5个请求。
  • 请求之间的最小间隔为12秒。

无需身份验证

data.gov.sg的API是公开的,无需身份验证。

📄 许可证

本项目采用MIT许可证。

🚧 开发与构建

开发

npx @smithery/cli dev

构建

npx @smithery/cli build
help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端