OpenGov MCP Server

OpenGov MCP サーバー

Claude Desktop のような MCP クライアントから Socrata Open Data API にアクセスできるようにする、MCP（Model Context Protocol）サーバーです。この連携により、Claude Desktop で政府のデータポータルから公開データセットを検索、取得、分析できます。

概要

この MCP サーバーは、都市、州、連邦政府機関のデータポータルを含む、Socrata を利用したあらゆるデータポータルのオープンデータにアクセスできます。例：

• シカゴ
• ニューヨーク市
• サンフランシスコ
• ロサンゼルス
• その他の政府機関

公開データにアクセスするため、基本的な利用に API キーは必要ありません。

機能

この MCP サーバーを使うと、クライアントは次の操作を行えます。

• キーワード、カテゴリ、タグでデータセットを検索、検出する
• データセットのメタデータと列の情報を表示する
• SQL に似たクエリを実行してデータを取得、分析する
• ポータルの利用統計を取得する

Claude Desktop へのインストール

npx でのクイックセットアップ（推奨）

この MCP サーバーを使う最も簡単な方法は npx を利用することです。インストールは不要です。

1. Claude Desktop の設定を作成または編集する：

   ホームディレクトリにある claude_desktop_config.json を作成または編集します。

   {
     "mcpServers": { 
       "opengov": {
         "command": "npx",
         "args": ["-y", "opengov-mcp-server@latest"],
         "env": {
           "DATA_PORTAL_URL": "https://data.cityofchicago.org"
         }
       }
     }
   }
   

   DATA_PORTAL_URL は、Socrata を利用した任意のデータポータルに置き換えられます。

2. Claude Desktop を再起動する（すでに起動している場合）

3. MCP サーバーの使用を開始する：

   Claude Desktop で、次のような質問をできるようになります。

   How many cars were towed in Chicago this month?
   

   さらに詳しく掘り下げる質問を続けて行うこともできます。

   Which make and color were towed the most?
   Also, were there any interesting vanity plates?
   

   クエリを初めて実行するときに、npx がサーバーの最新バージョンを自動的にダウンロードして実行します。

ソースから手動でインストール

ソースから実行する場合（開発やカスタマイズなど）は、次の手順に従ってください。

1. このリポジトリをクローンする：

   git clone https://github.com/srobbin/opengov-mcp-server.git
   cd opengov-mcp-server
   

2. 依存関係をインストールしてビルドする：

   npm install
   npm run build
   

3. Claude Desktop の設定を作成する：

   ホームディレクトリにある claude_desktop_config.json を作成または編集します。

   {
     "mcpServers": { 
       "opengov": {
         "command": "node",
         "args": [
           "/path/to/your/opengov-mcp-server/dist/index.js"
         ],
         "env": {
           "DATA_PORTAL_URL": "https://data.cityofchicago.org"
         }
       }
     }
   }
   

   /path/to/your/opengov-mcp-server を、リポジトリをクローンした実際のパスに置き換えます。

4. Claude Desktop を再起動する（すでに起動している場合）

利用可能なツール：get_data

この MCP サーバーは、Claude Desktop が Socrata のデータにアクセスするための統一ツール get_data を提供します。

パラメーター

• type（string、必須）：操作の種類

  • catalog：データセットを検索、一覧表示する
  • categories：データセットのカテゴリを一覧表示する
  • tags：データセットのタグを一覧表示する
  • dataset-metadata：データセットの詳細を取得する
  • column-info：データセットの列情報を取得する
  • data-access：レコードをクエリして取得する
  • site-metrics：ポータルの統計情報を取得する

• domain（string、任意）：データポータルのホスト名（プロトコルを除く）

• query（string、任意）：データセットの検索クエリ

• datasetId（string）：特定の操作で使用するデータセット識別子

• soqlQuery（string、任意）：データを絞り込むための SoQL クエリ

• limit（number、任意）：返す結果の最大数（デフォルト：10）

• offset（number、任意）：ページネーションでスキップする結果数（デフォルト：0）

クエリ例

以下は、Claude Desktop が MCP サーバーに送信するクエリの形式例です。

// Find datasets about budgets
{
  "type": "catalog",
  "query": "budget",
  "limit": 5
}

// Get information about a dataset
{
  "type": "dataset-metadata",
  "datasetId": "6zsd-86xi"
}

// Query dataset records with SQL-like syntax
{
  "type": "data-access",
  "datasetId": "6zsd-86xi",
  "soqlQuery": "SELECT * WHERE amount > 1000 ORDER BY date DESC",
  "limit": 10
}

設定オプション

このサーバーには、次の環境変数が必要です。

• DATA_PORTAL_URL：Socrata データポータルの URL（例：https://data.cityofchicago.org）

次の場所で設定できます。

• Claude Desktop の設定（推奨）
• 環境変数
• コマンドライン：DATA_PORTAL_URL=https://data.cityofchicago.org opengov-mcp-server