政府数据访问服务器

一个提供AI助手通过OpenDOSM和数据目录API访问马来西亚政府开放数据的模型上下文协议(MCP)服务器。

  • by lightyoruichi
  • JavaScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 lightyoruichi/datagovmy-mcp

使用说明

马来西亚数据政府MCP服务器

模型上下文协议(MCP)服务器,通过 OpenDOSM 和 数据目录 API。

主要特点

  • 需要零设置.使用TypeScript构建-只是 npx 走吧!
  • 全面的数据访问。连接到OpenDOSM和数据目录API。
  • 易于集成。用于查询数据集、过滤和分页的简单工具界面。

需求

  • Node.js 18或更新版本 - 下载Node.js
  • VS Code、Cursor、Windsurf、Claude Desktop、Goose或任何其他MCP客户端

入门指南

使用 npx (推荐)

使用此服务器的最简单方法-无需安装:

{
  "mcpServers": {
    "datagovmy": {
      "command": "npx",
      "args": [
        "-y",
        "@lightyoruichi/datagovmy-mcp"
      ]
    }
  }
}
Amp

通过Amp VS Code扩展设置屏幕或更新您的settings.json文件进行添加:

"amp.mcpServers": {
  "datagovmy": {
    "command": "npx",
    "args": [
      "-y",
      "@lightyoruichi/datagovmy-mcp"
    ]
  }
}

Amp CLI设置:

通过添加 amp mcp add 命令如下

amp mcp add datagovmy -- npx -y @lightyoruichi/datagovmy-mcp
Claude Code

使用Claude Code CLI添加马来西亚数据政府MCP服务器:

claude mcp add datagovmy npx -y @lightyoruichi/datagovmy-mcp
Claude Desktop

遵循MCP安装 指南,使用上面的标准配置。

配置文件位置:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • 视窗: %APPDATA%\Claude\claude_desktop_config.json

添加配置后,重新启动Claude Desktop。

Codex

使用Codex CLI添加马来西亚数据政府MCP服务器:

codex mcp add datagovmy npx "-y" "@lightyoruichi/datagovmy-mcp"

或者,创建或编辑配置文件 ~/.codex/config.toml 并添加:

[mcp_servers.datagovmy]
command = "npx"
args = ["-y", "@lightyoruichi/datagovmy-mcp"]

有关更多信息,请参阅 食品法典委员会MCP文件.

Copilot

使用Copilot CLI以交互方式添加马来西亚数据政府MCP服务器:

/mcp add

或者,创建或编辑配置文件 ~/.copilot/mcp-config.json 并添加:

{
  "mcpServers": {
    "datagovmy": {
      "type": "local",
      "command": "npx",
      "tools": [
        "*"
      ],
      "args": [
        "-y",
        "@lightyoruichi/datagovmy-mcp"
      ]
    }
  }
}

有关更多信息,请参阅 Copilot CLI文档.

Cursor

单击按钮安装:

或手动安装:

首选 Cursor Settings -> MCP -> Add new MCP Server.按你的喜好命名,使用 command 使用命令键入 npx -y @lightyoruichi/datagovmy-mcp。您还可以通过单击来验证配置或添加类似命令的参数 Edit.

Factory

使用Factory CLI添加马来西亚数据政府MCP服务器:

droid mcp add datagovmy "npx -y @lightyoruichi/datagovmy-mcp"

或者,键入 /mcp 在Factory droid中打开用于管理MCP服务器的交互式UI。

有关更多信息,请参阅 工厂MCP文件.

Gemini CLI

遵循MCP安装 指南,使用上面的标准配置。

Goose

单击按钮安装:

或手动安装:

首选 Advanced settings -> Extensions -> Add custom extension.按你的喜好命名,使用类型 STDIO,并设置 command 到 npx -y @lightyoruichi/datagovmy-mcp。单击“添加扩展名”。

Kiro

关注MCP服务器 文档例如,在 .kiro/settings/mcp.json:

{
  "mcpServers": {
    "datagovmy": {
      "command": "npx",
      "args": [
        "-y",
        "@lightyoruichi/datagovmy-mcp"
      ]
    }
  }
}
LM Studio

单击按钮安装:

或手动安装:

首选 Program 在右侧边栏-> Install -> Edit mcp.json.使用上面的标准配置。

opencode

关注MCP服务器 文档例如,在 ~/.config/opencode/opencode.json:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "datagovmy": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "@lightyoruichi/datagovmy-mcp"
      ],
      "enabled": true
    }
  }
}

Qodo Gen

打开 Qodo Gen VSCode或IntelliJ中的聊天面板→ 连接更多工具→ + 添加新MCP→ 粘贴上面的标准配置。

点击 保存.

VS Code

单击按钮安装:

或手动安装:

遵循MCP安装 指南,使用上面的标准配置。您还可以使用VS Code CLI安装马来西亚数据政府MCP服务器:

# For VS Code
code --add-mcp '{"name":"datagovmy","command":"npx","args":["-y","@lightyoruichi/datagovmy-mcp"]}'

安装后,马来西亚数据政府MCP服务器将可用于VS Code中的GitHub Copilot代理。

Warp

首选 Settings -> AI -> Manage MCP Servers -> + Add 到 添加MCP服务器.使用上面的标准配置。

或者,使用斜线命令 /add-mcp 在Warp提示符下,粘贴上面的标准配置:

{
  "mcpServers": {
    "datagovmy": {
      "command": "npx",
      "args": [
        "-y",
        "@lightyoruichi/datagovmy-mcp"
      ]
    }
  }
}
Windsurf

关注Windsurf MCP 文档.使用上面的标准配置。

地方发展

对于使用TypeScript的本地开发:

cd /Users/lightyoruichi/Dev/datagovmy-mcp

# Install dependencies
npm install

# Build the project
npm run build

# Link globally for testing
npm link

然后使用此配置:

{
  "mcpServers": {
    "datagovmy": {
      "command": "datagovmy-mcp"
    }
  }
}

备注: npm link 创建全局符号链接,使 datagovmy-mcp 命令在系统范围内可用。

或者用于自动重新加载的开发:

# Run directly with tsx (no build needed)
npm run dev

发现数据集

您有多种方法可以发现可用的数据集:

1.使用发现工具(推荐)

服务器提供内置工具来搜索和探索数据集:

# Ask your AI assistant:
"What datasets are available about fuel prices?"
"List all datasets in the Prices category"
"Show me datasets related to GDP"

AI将使用 search_datasets 和 list_datasets 工具自动查找相关数据。

2.浏览分类数据集

💰 Economy & Finance (OpenDOSM)
  • gdp -国内生产总值
  • gdp_qtr -按季度划分的国内生产总值
  • gdp_annual -年度GDP
  • ppi -生产者价格指数
  • trade -国际贸易
  • banking -银行统计
  • foreign_exchange -外汇汇率
  • property_prices -房地产价格

关键词:经济、gdp、增长、国民账户、贸易、金融

📊 Prices & Inflation (OpenDOSM & Data Catalogue)
  • cpi -消费者价格指数
  • cpi_core -核心消费者价格指数
  • inflation -通货膨胀率
  • fuelprice -每周燃油价格(RON95、RON97、柴油)
  • ppi -生产者价格指数

关键词:价格、通货膨胀、cpi、生活成本、燃料、汽油

👥 Population & Demography (OpenDOSM)
  • population -人口统计
  • population_malaysia -马来西亚人口
  • population_state -按州分列的人口
  • births -活产
  • deaths -死亡
  • marriage -婚姻
  • divorce -离婚

关键词:人口、人口统计、出生、死亡、生育率、死亡率

💼 Labour & Employment (OpenDOSM)
  • unemployment -失业率
  • lfs_monthly -劳动力调查(每月)
  • wages -工资和薪水

关键词:失业、劳动力、工作、工作、就业、劳动力、工资、薪水

🏥 Healthcare (OpenDOSM & Data Catalogue)
  • healthcare -医疗统计
  • blood_donation -献血
  • hospital_beds -医院病床
  • covid_cases -新冠肺炎病例
  • covid_vaccination -新冠肺炎疫苗接种

关键词:医疗保健,医疗,健康,医院,新冠肺炎,大流行

🏠 Households & Welfare (OpenDOSM)
  • poverty -贫困统计
  • hh_income -家庭收入

关键词:贫困、收入、家庭、收入、福利

🌍 Environment (OpenDOSM & Data Catalogue)
  • electricity -电力统计
  • renewable_energy -可再生能源
  • rainfall -降雨数据
  • air_quality -空气质量指数
  • water_quality -水质

关键词:环境、能源、电力、可再生能源、天气、气候、污染

🚔 Public Safety (OpenDOSM & Data Catalogue)
  • crime -犯罪统计

关键词:犯罪、安全、警察、执法

🚗 Transportation (Data Catalogue)
  • traffic -交通数据
  • vehicle_registration -车辆登记
  • public_transport -公共交通乘客量

关键词:交通、运输、车辆、轿车、公共汽车、火车

🏭 Economic Sectors (Data Catalogue)
  • agriculture -农业生产
  • manufacturing -制造业统计
  • construction -施工统计

关键词:农业、农业、制造业、工业、建筑业

📚 Education (Data Catalogue)
  • education -教育统计

关键词:教育、学校、学生、招生

🌴 Tourism (Data Catalogue)
  • tourist_arrivals -游客抵达

关键词:旅游业、游客、抵达人数、旅行

3.手动浏览(可选)

如果您愿意,您仍然可以直接浏览数据目录:

  1. OpenDOSM数据集: open.dosm.gov.my/数据目录
  2. 数据目录数据集: data.gov.my/数据目录

在每个数据集页面上,滚动到 “OpenAPI查询示例” 部分以查找数据集ID。

工具

Data Querying
  • 查询_待办事项
    • 标题:查询OpenDOSM数据集
    • 描述:查询OpenDOSM数据集(马来西亚统计局)
    • 参数:
      • dataset_id (字符串,必填):数据集ID(例如,“cpi_core”、“gdp”、“population”)
      • filters (string,可选):过滤参数的JSON字符串(例如,'{“date”:“2024-01-01”}')
      • limit (整数,可选):要返回的最大记录数(默认值:100)
      • offset (整数,可选):分页时要跳过的记录数(默认值:0)
    • 只读: 错误的
    • 示例用例:
      • 获取最新CPI数据: dataset_id='cpi_core', limit=10
      • 获取特定日期的GDP数据: dataset_id='gdp', filters='{"date": "2024-01-01"}'
  • 查询_数据_目录
    • 标题:查询数据目录数据集
    • 说明:查询数据目录数据集(更广泛的政府数据)
    • 参数:
      • dataset_id (字符串,必填):数据集ID(例如,“燃料价格”、“医疗保健”、“犯罪”)
      • filters (string,可选):过滤参数的JSON字符串(例如,'{“date”:“2024-01-01”}')
      • limit (整数,可选):要返回的最大记录数(默认值:100)
      • offset (整数,可选):分页时要跳过的记录数(默认值:0)
    • 只读: 错误的
    • 示例用例:
      • 获取最新燃油价格: dataset_id='fuelprice', limit=5
      • 获取筛选后的数据: dataset_id='fuelprice', filters='{"date": "2024-12-01"}'
  • get_dataset-metadata
    • 标题:获取数据集元数据
    • 描述:获取数据集的元数据,而不获取实际的数据记录
    • 参数:
      • dataset_id (字符串,必填):用于获取元数据的数据集ID
      • source (字符串,必填):数据源-“opendosm”或“Data_catalogue”
    • 只读: 真
    • 示例用例:
      • 获取燃油价格元数据: dataset_id='fuelprice', source='data_catalogue'
      • 获取CPI元数据: dataset_id='cpi_core', source='opendosm'
Dataset Discovery
  • 列表_数据集
    • 标题:列出可用数据集
    • 描述:列出所有可用的数据集,并可选择过滤
    • 参数:
      • source (字符串,可选):按源筛选-“opendosm”、“data_catalogue”或全部为“无”
      • category (字符串,可选):按类别筛选(例如,“价格”、“人口统计”、“经济”)
      • limit (整数,可选):要返回的最大数据集数(默认值:100)
      • offset (整数,可选):分页时要跳过的数据集数量(默认值:0)
    • 只读: 真
    • 示例用例:
      • 列出所有数据集:(无参数)
      • 列出OpenDOSM数据集: source='opendosm'
      • 与标价相关的数据集: category='Prices'
  • 搜索_数据集
    • 标题:搜索数据集
    • 描述:按关键字搜索数据集
    • 参数:
      • query (字符串,必填):搜索查询(按名称、描述、关键字和ID搜索)
      • source (字符串,可选):按源筛选-“opendosm”、“data_catalogue”或全部为“无”
      • limit (整数,可选):返回的最大结果数(默认值:10)
    • 只读: 真
    • 示例用例:
      • 搜索燃油数据: query='fuel'
      • 搜索GDP: query='gdp'
      • 搜索人口: query='population'
  • get_dataset_schema
    • 标题:获取数据集架构
    • 描述:获取数据集的架构、元数据和示例数据
    • 参数:
      • dataset_id (字符串,必填):用于获取架构的数据集ID
      • source (字符串,必填):数据源-“opendosm”或“Data_catalogue”
    • 只读: 真
    • 示例用例:
      • 获取燃油价格模式: dataset_id='fuelprice', source='data_catalogue'
      • 获取GDP模式: dataset_id='gdp', source='opendosm'

API详细信息

OpenDOSM API

  • 基本URL: https://api.data.gov.my/opendosm
  • 数据源:马来西亚统计局
  • 聚焦:经济和人口统计

API数据目录

  • 基本URL: https://api.data.gov.my/data-catalogue
  • 数据源:马来西亚各政府机构
  • 聚焦:更广泛的政府数据(医疗保健、犯罪、教育等)

这两个API都支持:

  • 使用查询参数进行筛选
  • 分页与 limit 和 offset
  • 元数据检索 meta_only=true

测试

与MCP检查员一起

# Terminal 1: Start the server in development mode
npm run dev

# Terminal 2: In a new terminal, launch Inspector
npx @modelcontextprotocol/inspector

检查器将在您的浏览器中打开。连接到您在终端1中启动的stdio服务器。

本地测试

# Build and link the package
npm run build
npm link

# The server is now available as 'datagovmy-mcp' command
# Configure your MCP client to use it

数据类别

目录包括这些类别的数据:

  • 人口统计学人口、出生、死亡、移民
  • 经济:国内生产总值、通货膨胀、贸易、生产率
  • 劳动就业、工资、劳动力
  • 价格:消费者价格、生产者价格、燃料
  • 医疗保健:卫生统计、疾病数据、基础设施
  • 教育:学校、入学人数、成绩
  • 公共安全:犯罪、司法系统
  • 环境:能源、污染、土地利用
  • 金融市场:银行、外汇
  • 运输:车辆登记、乘客量

贡献

欢迎投稿!请随时提交问题或拉取请求。

许可证

MIT许可证-有关详细信息,请参阅许可证文件

链接