Máy chủ JSON MCP

Máy chủ “JSON” MCP làm gì?

JSON MCP Server là một máy chủ Model Context Protocol (MCP) giúp trợ lý AI và LLM tương tác, truy vấn và thao tác với các nguồn dữ liệu JSON bằng các công cụ và thao tác tiêu chuẩn hóa. Máy chủ đóng vai trò cầu nối giữa client AI và dữ liệu ngoài dựa trên JSON, nâng cao quy trình phát triển cho các nhiệm vụ cần truy cập dữ liệu có cấu trúc, truy vấn nâng cao hoặc chuyển đổi. Nó hỗ trợ các tính năng mạnh như truy vấn dựa trên JSONPath, lọc theo điều kiện, thao tác mảng & chuỗi, tính toán ngày & số, và tổng hợp. Các nhà phát triển có thể tận dụng máy chủ để thực hiện thao tác giống cơ sở dữ liệu, phân tích dữ liệu và tự động hóa dựa trên dữ liệu mà không cần xây dựng tích hợp riêng cho từng nguồn.

Danh sách Prompt

Không có mẫu prompt rõ ràng nào được đề cập trong kho hoặc tài liệu.

Danh sách Tài nguyên

Không có tài nguyên rõ ràng nào được ghi tài liệu trong kho hoặc README. Máy chủ hoạt động với dữ liệu JSON ngoài qua URL, nhưng không liệt kê tài nguyên định nghĩa sẵn.

Danh sách Công cụ

• query
  Truy vấn dữ liệu JSON bằng cú pháp JSONPath với các thao tác mở rộng.
  Input:

  • url (string): URL nguồn dữ liệu JSON
  • jsonPath (string): Biểu thức JSONPath với thao tác tùy chọn

• filter
  Lọc dữ liệu JSON bằng điều kiện.
  Input:

  • url (string): URL nguồn dữ liệu JSON
  • jsonPath (string): Biểu thức JSONPath cơ bản
  • condition (string): Điều kiện lọc

Các trường hợp sử dụng của MCP Server này

• Phân tích dữ liệu trên API JSON
  Cho phép nhà phát triển hoặc LLM chạy các truy vấn phức tạp, tổng hợp và tính toán thống kê trực tiếp trên phản hồi API JSON từ xa, đơn giản hóa quy trình phân tích dữ liệu.

• Chuyển đổi dữ liệu tự động
  Tự động ánh xạ, lọc và chuyển đổi tập dữ liệu JSON lớn cho quy trình ETL (Extract, Transform, Load), tiết kiệm thời gian viết script thủ công.

• Tạo dashboard động
  Hỗ trợ backend cho dashboard cần tổng hợp và trực quan hóa số liệu từ nhiều endpoint JSON thông qua công cụ sắp xếp, nhóm và tổng hợp.

• Tạo mẫu nhanh với dữ liệu trực tiếp
  Cho phép LLM hoặc người dùng truy vấn, thao tác dữ liệu JSON trực tiếp phục vụ proof-of-concept hoặc phân tích dữ liệu khám phá.

• Lọc dữ liệu theo quy tắc
  Giúp nhà phát triển lọc và trích xuất thông tin liên quan từ nguồn JSON theo điều kiện lập trình động.

Cách thiết lập

Windsurf

1. Đảm bảo Node.js đã được cài trên hệ thống.
2. Tìm tệp cấu hình Windsurf của bạn.
3. Thêm cấu hình JSON MCP Server vào trong đối tượng mcpServers:

   {
     "json": {
       "command": "npx",
       "args": [
         "@gongrzhe/server-json-mcp@latest"
       ]
     }
   }
   

4. Lưu cấu hình và khởi động lại Windsurf.
5. Xác minh máy chủ xuất hiện trong danh sách MCP server khả dụng.

Claude

1. Đảm bảo Node.js đã được cài đặt.
2. Mở tệp claude_desktop_config.json.
3. Thêm đoạn sau vào cấu hình:

   {
     "json": {
       "command": "npx",
       "args": [
         "@gongrzhe/server-json-mcp@1.0.3"
       ]
     }
   }
   

4. Lưu cấu hình và khởi động lại Claude Desktop.
5. Kiểm tra xem Máy chủ JSON MCP đã khả dụng chưa.

Cursor

1. Cài đặt Node.js nếu chưa có.
2. Mở tệp cấu hình Cursor MCP.
3. Thêm đoạn sau:

   {
     "json": {
       "command": "npx",
       "args": [
         "@gongrzhe/server-json-mcp@latest"
       ]
     }
   }
   

4. Lưu và khởi động lại Cursor.
5. Xác nhận máy chủ MCP đang chạy qua danh sách server của Cursor.

Cline

1. Cài đặt Node.js.
2. Tìm và chỉnh sửa cấu hình Cline MCP.
3. Thêm:

   {
     "json": {
       "command": "npx",
       "args": [
         "@gongrzhe/server-json-mcp@latest"
       ]
     }
   }
   

4. Lưu thay đổi và khởi động lại Cline.
5. Kiểm tra máy chủ đã truy cập được trong Cline chưa.

Bảo mật API Key

Nếu endpoint JSON của bạn cần xác thực, hãy đặt API key qua biến môi trường và tham chiếu trong cấu hình máy chủ. Ví dụ:

{
  "json": {
    "command": "npx",
    "args": [
      "@gongrzhe/server-json-mcp@latest"
    ],
    "env": {
      "API_KEY": "${API_KEY}"
    },
    "inputs": {
      "api_key": "${API_KEY}"
    }
  }
}

Thay ${API_KEY} bằng biến môi trường thực tế hoặc giải pháp quản lý bí mật của bạn.

Cách sử dụng MCP này trong flow

Sử dụng MCP trong FlowHunt

Để tích hợp máy chủ MCP vào quy trình FlowHunt, hãy thêm thành phần MCP vào flow của bạn và kết nối với tác nhân AI:

Nhấp vào thành phần MCP để mở bảng cấu hình. Trong phần cấu hình hệ thống MCP, dán chi tiết máy chủ MCP của bạn theo định dạng JSON sau:

{
  "json": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

Sau khi cấu hình, tác nhân AI có thể sử dụng MCP này như một công cụ với đầy đủ chức năng của nó. Lưu ý đổi “json” thành tên thực tế của máy chủ MCP bạn dùng và thay URL bằng địa chỉ máy chủ của bạn.

Tổng quan

Đánh giá của chúng tôi

JSON MCP Server là một máy chủ MCP tập trung và thực tiễn cho xử lý dữ liệu JSON, cung cấp công cụ truy vấn và lọc mạnh mẽ nhưng thiếu các tính năng nâng cao như mẫu prompt, định nghĩa tài nguyên rõ ràng và hỗ trợ sampling/roots. Máy chủ đạt điểm cao về tính hữu dụng và đơn giản, đặc biệt cho quy trình tập trung vào dữ liệu.

Điểm MCP: 6/10

Điểm MCP