Fetch Jsonpath MCP

🚀 Fetch JSONPath MCP

Fetch JSONPath MCPは、JSONPathパターンを使用してURLからJSONデータを取得および抽出するツールを提供するModel Context Protocol (MCP)サーバーです。

🚀 クイックスタート

Fetch JSONPath MCPは、JSONPathパターンを使ってURLから必要なJSONデータのみを抽出することができます。これにより、LLMのトークン使用量を削減し、モデルの幻覚を減らすことができます。

✨ 主な機能

• LLMのトークン使用量と幻覚の削減：必要なデータのみを抽出することで、不要なトークンの浪費を防ぎます。
• 高速な処理：小さなペイロードにより、LLMの応答が高速化されます。
• 正確な出力：関連性のないデータが少ないため、出力がより正確になります。
• コスト削減：トークン使用量が少ないため、APIコストが削減されます。
• タスクへの集中：クリーンなデータにより、モデルがタスクに集中しやすくなります。

従来の取得方法とJSONPath抽出の比較

❌ 従来の取得方法（無駄が多い）：

// APIが2000以上のトークンを返す
{
  "data": [
    {
      "id": 1,
      "name": "Alice",
      "email": "alice@example.com", 
      "avatar": "https://...",
      "profile": {
        "bio": "Long bio text...",
        "settings": {...},
        "preferences": {...},
        "metadata": {...}
      },
      "posts": [...],
      "followers": [...],
      "created_at": "2023-01-01",
      "updated_at": "2024-01-01"
    },
    // ... 他に50人以上のユーザー
  ],
  "pagination": {...},
  "meta": {...}
}

✅ JSONPath抽出（効率的）：

// 必要な部分のみで、わずか10トークン！
["Alice", "Bob", "Charlie"]

data[*].nameというパターンを使用することで、99%のトークンを節約し、関連性のないデータによるモデルの幻覚を排除することができます。

📦 インストール

ほとんどのIDEでは、uvxツールを使用してサーバーを実行します。

{
  "mcpServers": {
    "fetch-jsonpath-mcp": {
      "command": "uvx",
      "args": [
        "fetch-jsonpath-mcp"
      ]
    }
  }
}

claude mcp add fetch-jsonpath-mcp -- uvx fetch-jsonpath-mcp

{
  "mcpServers": {
    "fetch-jsonpath-mcp": {
      "command": "uvx",
      "args": ["fetch-jsonpath-mcp"]
    }
  }
}

{
  "mcpServers": {
    "fetch-jsonpath-mcp": {
      "command": "uvx",
      "args": ["fetch-jsonpath-mcp"]
    }
  }
}

"mcp": {
  "servers": {
    "fetch-jsonpath-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": ["fetch-jsonpath-mcp"]
    }
  }
}

💻 使用例

基本的な使用法

get-json

JSONPathパターンを使用してJSONデータを抽出します。

{
  "name": "get-json",
  "arguments": {
    "url": "http://localhost:8080",
    "pattern": "foo[*].baz"
  }
}

戻り値: [1, 2]

get-text

任意のURLから生のテキストコンテンツを取得します。

{
  "name": "get-text",
  "arguments": {
    "url": "http://localhost:8080"
  }
}

戻り値: {"foo": [{"baz": 1, "qux": "a"}, {"baz": 2, "qux": "b"}], "bar": {"items": [10, 20, 30], "config": {"enabled": true, "name": "example"}}, "metadata": {"version": "1.0.0"}}

batch-get-json

複数のURLを異なるJSONPathパターンで処理します。

{
  "name": "batch-get-json",
  "arguments": {
    "requests": [
      {"url": "http://localhost:8080", "pattern": "foo[*].baz"},
      {"url": "http://localhost:8080", "pattern": "bar.items[*]"}
    ]
  }
}

戻り値: [[1, 2], [10, 20, 30]]

batch-get-text

複数のURLからテキストコンテンツを取得します。

{
  "name": "batch-get-text",
  "arguments": {
    "urls": ["http://localhost:8080", "http://localhost:8080"]
  }
}

戻り値: ["JSON content...", "JSON content..."]

📚 ドキュメント

JSONPathの例

このプロジェクトは、JSONPathの実装にjsonpath-ngを使用しています。

完全なJSONPath構文のリファレンスについては、jsonpath-ngドキュメントを参照してください。

デモサーバーデータ

http://localhost:8080のデモサーバーは以下のようなレスポンスを返します。

{
  "foo": [{"baz": 1, "qux": "a"}, {"baz": 2, "qux": "b"}],
  "bar": {
    "items": [10, 20, 30], 
    "config": {"enabled": true, "name": "example"}
  },
  "metadata": {"version": "1.0.0"}
}

🔧 技術詳細

開発環境のセットアップ

1. 依存関係のインストール

uv sync

2. デモサーバーの起動（オプション）

# デモサーバーの依存関係をインストール
uv add fastapi uvicorn

# ポート8080でデモサーバーを起動
uv run demo-server

3. MCPサーバーの実行

uv run fetch-jsonpath-mcp

パフォーマンスの利点

• トークン効率：必要なデータのみを抽出するため、全体のJSONレスポンスを取得する必要がありません。
• 高速な処理：小さなペイロードにより、LLMの応答が高速化されます。
• 幻覚の削減：関連性のないデータが少ないため、出力がより正確になります。
• コスト削減：トークン使用量が少ないため、APIコストが削減されます。
• タスクへの集中：クリーンなデータにより、モデルがタスクに集中しやすくなります。

設定

環境変数を設定します。

export JSONRPC_MCP_TIMEOUT=30
export JSONRPC_MCP_HEADERS='{"Authorization": "Bearer token"}'
export JSONRPC_MCP_PROXY="http://proxy.example.com:8080"

開発

# テストの実行
pytest

# コード品質のチェック
ruff check --fix