Json Query MCP

🚀 JSON 查询 MCP サーバー

このサーバーは、大規模な JSON ファイルをクエリするための Model Context Protocol (MCP) サーバーです。Model Context Protocol を使用した大規模言語モデルに対して、大規模な JSON データを処理するツールを提供します。

🚀 クイックスタート

このサーバーは、大規模な JSON データを扱う際に便利なツールです。JSONPath を使ったクエリや、キーや値の類似検索が可能です。

✨ 主な機能

• JSONPath 式を使って JSON ファイルをクエリすることができます。
• クエリ文字列に類似したキーを検索できます。
• クエリ文字列に類似した値を検索できます。

💻 使用例

基本的な使用法

以下は、Cursor エージェントがこのツールを使って非常に大きな（>1M 文字）JSON Swagger 定義ファイルを読み取り、TypeScript インターフェースを記述するために一部を抽出する例です。

高度な使用法

このサーバーを Cursor で使用するには、以下の手順を行います。

📦 インストール

直接実行

npx json-query-mcp を実行します。

Cursor でのインストール

以下の内容をあなたの Cursor mcp 設定ファイル（macOS では /Users/$USER/.cursor/mcp.json）に追加します。

{
  "mcpServers": {
    ... 他の MCP サーバー
    "json-query": {
      "command": "npx",
      "args": [<このリポジトリへのローカルパス>],
    },
  }
}

🔧 技術詳細

開発に関するコマンドは以下の通りです。

# 開発モードで実行
npm run dev

# テストを実行
npm test

# コードを整形
npm run format

# コードスタイルをチェック
npm run lint

# チェック問題を修正
npm run fix

📄 ライセンス

このプロジェクトは MIT ライセンスの下で提供されています。