streamparse

streamparse-mcp

AI アシスタントが、不完全な JSON や乱れた JSON、途中で切れた JSON を解析できるようにする MCP サーバーです。

@mukundakatta/streamparse をベースに構築されています。 Claude Desktop、Cursor、Cline、Windsurf、Zed、およびその他あらゆる MCP クライアントで動作します。

公開されているツール

parse_partial_json

途中で切れている可能性のある文字列から JSON 値を復元します。開いた文字列、配列、オブジェクトを補完して、常に有効な値を返します。

{
  "text": "{\"type\":\"tool_use\",\"name\":\"edit_file\",\"input\":{\"path\":\"a/b.ts\",\"cont"
}

→

{
  "value": {
    "type": "tool_use",
    "name": "edit_file",
    "input": { "path": "a/b.ts", "cont": null }
  },
  "complete": false,
  "path": ["input", "cont"],
  "bytes_consumed": 67,
  "confidence": 0.65
}

extract_json_from_text

LLM の出力に埋め込まれた JSON 値の周囲にある文章、```json フェンス、コメントを取り除きます。最初に解析できた値を返します。

Sure, here you go:
```json
{ "answer": 42 }

ご意見をお聞かせください！

→ `{ "answer": 42 }`

### `validate_json`

Strict-mode RFC 8259 validator. Returns `ok=true` and the parsed value on
success, or `ok=false` with a precise byte position and error message on
failure.

## Install

### Claude Desktop

Add to `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "streamparse": {
      "command": "npx",
      "args": ["-y", "@mukundakatta/streamparse-mcp"]
    }
  }
}

Cursor / Cline / Windsurf / Zed

クライアントに適した mcp.json で、同じ形式を使用してください。ほとんどのクライアントは npx -y @mukundakatta/streamparse-mcp を使って自動検出します。

ローカルインストール

npm install -g @mukundakatta/streamparse-mcp
mcp-streamparse        # listens on stdio

これが重要な理由

LLM がツール呼び出しの途中にあり、書きかけの JSON をアシスタントに推論させたい場合、実用的な答えを返せるツールは他にありません。標準の JSON.parse は例外をスローします。正規表現による抽出では、ネストされた構造を見落とします。この MCP サーバーを使えば、JSON があるその場で、Claude（または処理を実行するその他のモデル）が不完全な JSON を実際に扱えるようになります。

ライセンス

MIT。