JSONデータのクエリと操作のためのJSONモデルコンテキストプロトコル(MCP)サーバー実装。このサーバーにより、LLMは標準化されたツールセットを通じてJSONデータを操作できるようになります。
インストールと使用方法
# Using npx with specific version (recommended)
npx @gongrzhe/server-json-mcp@1.0.3
# Install specific version globally
npm install -g @gongrzhe/server-json-mcp@1.0.3
# Run after global installation
server-json-mcp
コンポーネント
ツール
- クエリ
- 拡張操作を含む JSONPath 構文を使用して JSON データをクエリする
- 入力:
url
(文字列): JSONデータソースのURLjsonPath
(文字列): オプションの操作を含むJSONPath式
- フィルター
- 条件を使用してJSONデータをフィルタリングする
- 入力:
url
(文字列): JSONデータソースのURLjsonPath
(文字列): ベースJSONPath式condition
(文字列): フィルター条件
サポートされている操作
配列操作
- スライス:
$[0:5]
、 $[-3:]
、 $[1:4]
- ソート:
$.sort(price)
、 $.sort(-price)
- 個別:
$.distinct()
- 変換:
- マップ:
$.map(fieldName)
- フラット化:
$.flatten()
- ユニオン:
$.union([1,2,3])
- 交差点:
$.intersection([1,2,3])
文字列操作
- 大文字と小文字:
$.toLowerCase()
、 $.toUpperCase()
- テスト:
$.startsWith('test')
、 $.endsWith('test')
- 検索:
$.contains('test')
、 $.matches('pattern')
数値演算
- 数学:
$.math(+10)
、 $.pow2()
- 丸め:
$.round()
、 $.floor()
、 $.ceil()
- 関数:
$.abs()
、 $.sqrt()
日付操作
- フォーマット:
$.format('YYYY-MM-DD')
- チェック:
$.isToday()
- 変更:
$.add(1, 'days')
集計操作
- グループ:
$.groupBy(category)
- 統計:
$.sum(price)
、 $.avg(price)
、 $.min(price)
、 $.max(price)
構成
Claude Desktopでの使用
このサーバーを Claude Desktop アプリで使用するには、 claude_desktop_config.json
に次の構成を追加します。
{
"json": {
"command": "npx",
"args": [
"@gongrzhe/server-json-mcp@1.0.3"
]
}
}
あるいは、パッケージがインストールされている場合は、node コマンドを直接使用することもできます。
{
"json": {
"command": "node",
"args": [
"path/to/build/index.js"
]
}
}
発達
ソースから構築
- リポジトリをクローンする
- 依存関係をインストールします:
- プロジェクトをビルドします。
注記
- すべてのJSONPath式はルートオブジェクトを表す
$
で始まります - 配列のインデックスはゼロベースです
- 演算内の文字列値は引用符で囲む必要があります
- 日付演算は「日」、「月」、「年」単位をサポートします
- 数値演算では基本的な算術演算子 (+、-、、/) がサポートされます。
ライセンス
マサチューセッツ工科大学