JSON Manipulation

🚀 JSON 模型上下文協議 (MCP) 服務器 (@gongrzhe/server-json-mcp@1.0.3)

本項目是一個用於查詢和操作 JSON 數據的 JSON Model Context Protocol (MCP) 服務器實現。藉助該服務器，大語言模型 (LLMs) 能夠通過一組標準化工具與 JSON 數據進行交互。

🚀 快速開始

此服務器的安裝與使用方式如下：

# 使用 npx 和特定版本（推薦）
npx @gongrzhe/server-json-mcp@1.0.3

# 全局安裝特定版本
npm install -g @gongrzhe/server-json-mcp@1.0.3

# 全局安裝後運行
server-json-mcp

✨ 主要特性

組件

工具

• query
  • 可使用 JSONPath 語法查詢 JSON 數據，還支持擴展操作。
  • 輸入參數：
    • url (字符串)：JSON 數據源的 URL。
    • jsonPath (字符串)：帶有可選操作的 JSONPath 表達式。
• filter
  • 能根據條件過濾 JSON 數據。
  • 輸入參數：
    • url (字符串)：JSON 數據源的 URL。
    • jsonPath (字符串)：基礎 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 文件：

{
  "config": {
    "@gongrzhe/server-json-mcp@1.0.3": {
      // 配置選項
    }
  }
}

開發

若要從源代碼構建，請按以下步驟操作：

1. 克隆倉庫：

   git clone https://github.com/your-username/your-repository.git
   cd your-repository
   

2. 安裝依賴：

   npm install
   

3. 構建項目：

   npm run build
   

⚠️ 重要提示

• 請確保安裝正確版本的依賴。
• 在生產環境中使用前，請進行全面測試。