JSON MCP Lite

json-mcp-lite

JSON ファイルを1つのコマンドで MCP サーバー に変換できるため、Claude Desktop、Claude Code、Cursor、または stdio 対応の MCP クライアントからデータを閲覧・検索できます。

カタログ、FAQ、価格表、ドキュメントのインデックスを渡すと、読み取り専用のツールを3つ作成します。

ツール	機能
<name>_list	limit／offset によるページ分割でレコードを一覧表示します
<name>_search	キーワード検索。大文字と小文字を区別せず、すべての単語が一致する必要があります
<name>_get	ID フィールドでレコードを1件取得します

MIT ライセンス。Node.js 20 以上。依存関係は2つで、公式の @modelcontextprotocol/sdk と zod です。

試してみる

git clone https://github.com/scoretracker4321/json-mcp-lite
cd json-mcp-lite && npm install
npm start          # serves examples/products.json on stdio
npm test

Claude Desktop または Cursor で使う

{
  "mcpServers": {
    "products": {
      "command": "node",
      "args": [
        "/abs/path/json-mcp-lite/src/server.js",
        "--file", "/abs/path/products.json",
        "--name", "products",
        "--id", "sku",
        "--search", "title,description"
      ]
    }
  }
}

Claude Code：

claude mcp add products -- node /abs/path/json-mcp-lite/src/server.js --file /abs/path/products.json --name products --id sku

次のように尋ねてみましょう：「₹400未満で在庫があるお茶はどれですか？」 または 「商品 MUG-001 を表示して。」

オプション

フラグ	デフォルト	意味
--file	(必須)	JSON ファイル
--path	root	ファイル内の配列へのドットパス。例：data.items
--name	records	ツール名の接頭辞：products → products_list、…
--id	id	<name>_get が使用するフィールド
--search	すべてのフィールド	<name>_search が検索するフィールドをカンマ区切りで指定します

JSON ファイル以上の機能が必要ですか？

json-mcp-lite は、MCP Server Kit（29ドル、買い切り）の無料ローカル単一ファイル版です。Kit では、次の機能が利用できます。

• OpenAPI 3 仕様から あらゆる REST API を MCP ツールに変換：操作ごとに型付きツールを作成し、認証情報を環境変数から挿入。読み取り専用フィルター、対象に含める項目／除外する項目のリストにも対応
• stdio だけでなく、Streamable HTTP による リモートホスティング（ステートレスで、プロキシに対応）
• API キー認証とキーごとのレート制限、CORS、/health および /tools エンドポイント
• 1つの YAML／JSON 設定ファイルで、複数のデータソースを1つのサーバーに設定
• Docker イメージ、自分のアプリ内にマウントできる Express ルーター、デプロイガイド

	json-mcp-lite	MCP Server Kit
JSON ファイル → list／search／get	✅	✅
stdio（Claude Desktop、Cursor、Claude Code）	✅	✅
OpenAPI／REST API → ツール		✅
リモート HTTP サーバー		✅
API キー＋レート制限		✅
複数のデータソース、設定ファイル		✅
Docker＋デプロイ用ドキュメント		✅
メールサポート		✅

ライセンス

MIT。Brain Grain が開発しました（[email protected]）。