json

mcp-json-tools

AI エージェント向けに JSON およびデータ操作ツールを提供する MCP（Model Context Protocol）サーバーです。Claude Code、Claude Desktop、その他の MCP 互換クライアントでの使用を想定して設計されています。

ツール

ツール	説明
json_validate	JSON データを JSON Schema に照らして検証し、パス付きの詳細なエラーを返します
json_diff	2 つの JSON オブジェクトを比較し、パス付きで追加、削除、変更を表示します
json_transform	pick、rename、flatten、unflatten 操作で JSON を変換します
csv_to_json	ヘッダー、区切り文字、型変換を設定して、CSV テキストを JSON 配列に変換します
json_to_csv	JSON オブジェクトの配列を CSV テキストに変換します
yaml_to_json	YAML テキストを JSON に変換します
json_to_yaml	JSON テキストを YAML に変換します

インストール

npm install
npm run build

Claude Code での使用方法

claude mcp add json-tools -- node D:/products/mcp-servers/mcp-json-tools/dist/index.js

Claude Desktop での使用方法

以下を Claude Desktop の設定ファイルに追加します。

Windows： %APPDATA%\Claude\claude_desktop_config.json macOS： ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "json-tools": {
      "command": "node",
      "args": ["D:/products/mcp-servers/mcp-json-tools/dist/index.js"]
    }
  }
}

ツールの詳細

json_validate

JSON データを JSON Schema に照らして検証します。valid の真偽値と、フィールドパス、メッセージ、失敗したスキーマキーワードをそれぞれ含むエラーの配列を返します。

パラメーター：

• data (string) — 検証する JSON データ
• schema (string) — 検証に使用する JSON Schema

json_diff

2 つの JSON オブジェクトを比較し、構造化された差分を生成します。各差分には、ドット記法のパス、変更の種類（追加、削除、変更）、変更前後の値が含まれます。

パラメーター：

• original (string) — 元の JSON オブジェクト
• modified (string) — 変更後の JSON オブジェクト

json_transform

JSON データに変換処理を適用します。以下の 4 つの操作に対応しています。

• pick — ドット記法のパスで指定したフィールドを抽出します
• rename — マッピングオブジェクトを使ってトップレベルのキーを変更します
• flatten — ネストされたオブジェクトをドット区切りのキーに平坦化します
• unflatten — ドット区切りのキーをネストされたオブジェクトに戻します

パラメーター：

• data (string) — 変換する JSON データ
• operation (string) — 次のいずれか：pick、rename、flatten、unflatten
• fields (string[]) — pick 用：抽出するフィールドパス
• mapping (object) — rename 用：変更前から変更後へのキーのマッピング
• separator (string) — flatten/unflatten 用：区切り文字（デフォルト：「.」）

csv_to_json

CSV テキストを JSON オブジェクトの配列に解析します。

パラメーター：

• csv (string) — 変換する CSV テキスト
• hasHeaders (boolean) — 先頭行がヘッダーかどうか（デフォルト：true）
• delimiter (string) — 列の区切り文字（デフォルト：「,」）
• castTypes (boolean) — 数値とブール値を自動的に型変換するかどうか（デフォルト：false）

json_to_csv

JSON オブジェクトの配列を CSV テキストに変換します。ヘッダーは、すべてのオブジェクトキーの和集合から生成されます。

パラメーター：

• data (string) — 変換する JSON 配列
• delimiter (string) — 列の区切り文字（デフォルト：「,」）
• includeHeaders (boolean) — ヘッダー行を含めるかどうか（デフォルト：true）

yaml_to_json / json_to_yaml

YAML 形式と JSON 形式を相互に変換します。

パラメーター：

• yamlText / jsonText (string) — 変換するテキスト
• indent (number) — インデントのスペース数（デフォルト：2）

ライセンス

MIT