Opendata MCP

🚀 Open Data MCP

Open Data MCP是一個Model Context Protocol（MCP）服務器，旨在幫助用戶更便捷地探索和調用韓國公共數據門戶（OpenAPI）。它提供了以下MCP工具：

• search_api：通過關鍵字搜索公共數據API。
• get_std_docs：從搜索結果中選擇 listId 列表，合併標準文檔（Markdown）。
• fetch_data：根據標準文檔/元數據調用實際的OpenAPI端點。

該服務器內部的搜索/文檔工具使用 mcp.ezrnd.co.kr（HTTPS）後端。

🚀 快速開始

若要使用Open Data MCP，你需要滿足以下要求並完成安裝和運行步驟。

✨ 主要特性

• 提供便捷的API搜索功能，支持使用關鍵字查找公共數據API。
• 可以將搜索結果中的標準文檔進行合併。
• 基於OpenAPI元數據調用特定端點獲取數據。

📦 安裝指南

要求

• Node.js ≥ 18.17（推薦使用最新的LTS版本）
• npm（包管理器）

安裝命令

npm install

💻 使用示例

開發環境運行

你可以使用Smithery CLI來啟動MCP開發服務器。

npm run dev

⚠️ 重要提示

@smithery/cli 作為MCP主機，在測試環境中由於部分功能不支持，無法注入 ODP_SERVICE_KEY，後續計劃通過環境變量等方式實現預先注入，以便能夠正常啟動服務器。

📚 詳細文檔

環境變量

• ODP_SERVICE_KEY：公共數據門戶服務密鑰。部分API需要通過查詢參數或Authorization頭注入此密鑰。
  • 若參數名稱包含 serviceKey，則會自動注入。
  • 若頭名稱包含 Authorization，則會以 {Prefix} {密鑰} 的格式自動注入。

提供工具詳情

search_api

• 說明：在公共數據門戶中使用關鍵字搜索API列表。
• 輸入：
  • query：字符串數組（無空格的關鍵字，建議最多5個）
  • page：頁碼（從1開始）
  • pageSize：每頁顯示數量
• 輸出：搜索結果（JSON字符串）

get_std_docs

• 說明：接收 search_api 結果中所選條目的 listId 數組，併合並返回標準文檔（Markdown）。
• 輸入：
  • listId：number[]
• 輸出：合併後的Markdown字符串

fetch_data

• 說明：基於OpenAPI元數據調用特定端點，默認協議為HTTPS。
• 輸入：requestData
  • baseInfo.host：例如 apis.data.go.kr（禁止包含協議/斜槓）
  • baseInfo.base_path：例如 /B552015/NpsBplcInfoInqireServiceV2
  • endpointInfo.path：例如 /getBassInfoSearchV2
  • endpointInfo.method：GET 或 POST
  • endpointInfo.params：[{ name, value }] 數組，值為空則排除。
  • endpointInfo.headers：[{ name, prefix, value }] 數組，支持自動將服務密鑰注入 Authorization。
  • endpointInfo.body：POST請求體（JSON）
• 輸出：響應體（JSON字符串或文本）

📄 許可證

有關此倉庫的許可證信息，請參考根目錄下的 LICENSE 文件。