使用说明
马来西亚数据政府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
}
}
}
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-年度GDPppi-生产者价格指数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.手动浏览(可选)
如果您愿意,您仍然可以直接浏览数据目录:
- OpenDOSM数据集: open.dosm.gov.my/数据目录
- 数据目录数据集: 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"}'
- 获取最新CPI数据:
- 查询_数据_目录
- 标题:查询数据目录数据集
- 说明:查询数据目录数据集(更广泛的政府数据)
- 参数:
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(字符串,必填):用于获取元数据的数据集IDsource(字符串,必填):数据源-“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(字符串,必填):用于获取架构的数据集IDsource(字符串,必填):数据源-“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许可证-有关详细信息,请参阅许可证文件