json-mender-mcp

JSON Mender MCP — AI エージェント向けの不正な JSON の修復、JSON Schema の検証、正規表現のテスト

LLM の壊れた JSON 出力を修復し、実際の JSON Schema に照らしてデータを検証し、正規表現パターンを決定的にテストする、無料のローカル MCP サーバーです。API キーもネットワーク呼び出しもテレメトリーもありません。

AI エージェントを構築していて、モデルの出力に JSONDecodeError、閉じていない文字列、末尾のカンマ、引用符で囲まれていないキーが頻繁に含まれる場合、これはまさにその問題を解決する MCP サーバーです。

polymath-megablaster-mcp と同じローカルファーストで決定的な方針を、「モデルがパースできない JSON を書いた」という問題に特化して適用しています。

解決する問題

LLM、特に小型モデルやローカルモデル（Llama、Qwen、Mistral）は、見た目は正しくてもパースに失敗する JSON を頻繁に生成します。末尾のカンマ、二重引用符ではなくシングルクォートを使った文字列、エスケープされていない内部の引用符、欠落したカンマ、途中で切れた出力などです。モデルに「JSON を修正して」と頼んでも、たいていは再び壊れたものが返ってきます。repair_json は、2 回目のモデル呼び出しを必要とせず、毎回同じ方法で決定的に修復します。

ツール

• repair_json — 不正な JSON（末尾のカンマ、引用符で囲まれていないキー、エスケープされていない引用符、途中で切れた構造など）を修復し、修正済みのパース結果を返します。jsonrepair を基盤としています。
• validate_regex — 1 つ以上の文字列に対して、正規表現パターンを決定的にテストします。モデルは、コンパイルには成功しても、想定どおりに一致しない正規表現を頻繁に書くため便利です。
• validate_against_schema — 実際の JSON Schema（広く使われている JS Schema バリデーターである ajv を使用）に照らして任意の JSON データを検証し、一般的な合否ではなく、フィールドごとの正確で分かりやすいエラーメッセージを取得します。

セットアップ

1. Node.js をインストールします（v18 以降）。まだインストールされていない場合は、こちらから入手してください：https://nodejs.org

2. クローンしてインストールします：

git clone https://github.com/headlessherm-creator/json-mender-mcp.git
cd json-mender-mcp
npm install

3. MCP クライアントに接続先として指定します：

{
  "mcpServers": {
    "json-mender": {
      "command": "node",
      "args": ["/path/to/json-mender-mcp/src/index.js"]
    }
  }
}

一般的なクライアントのセットアップドキュメント：

• Claude Desktop：https://modelcontextprotocol.io/quickstart/user
• Cursor：https://docs.cursor.com/context/model-context-protocol
• Claude Code：https://docs.claude.com/en/docs/claude-code/mcp

ローカルで実行する理由

src/tools.js のどこにも fetch／http のインポートはありません。すべてのツールは、どちらも実績があり、活発にメンテナンスされている npm パッケージである jsonrepair と ajv を使って、完全にローカルで処理を実行します。このサーバーに送信したデータが、マシンの外に出ることはありません。

キーワード

JSON 修復 MCP サーバー、LLM が生成した壊れた JSON の修正、不正な JSON パーサー、JSON Schema 検証 MCP、正規表現テスター MCP、API キー不要のローカル MCP サーバー、Claude MCP JSON ツール、AI エージェントの構造化出力の検証。

関連ツール

同じローカルファーストの方針で、異なる問題を解決します：

• polymath-megablaster-mcp — 決定的な数学、日付、単位変換、ネットワーキング
• hiring-mender-mcp — BambooHR と Greenhouse ATS の書き込みツールを、共通の語彙で提供
• helpdesk-mender-mcp — Zendesk、Freshdesk、Help Scout の書き込みツールを、共通の語彙で提供

ライセンス

MIT