Máy chủ MCP GraphQL

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

MCP GraphQL là một máy chủ Model Context Protocol (MCP) được thiết kế để cung cấp giao diện chuẩn cho việc tương tác với API GraphQL. Bằng cách kiểm tra một endpoint GraphQL mục tiêu, nó tự động phơi bày mỗi truy vấn GraphQL khả dụng thành một công cụ MCP riêng biệt, cho phép trợ lý AI và lập trình viên tương tác liền mạch với nguồn dữ liệu GraphQL bên ngoài. Điều này hỗ trợ các tác vụ như truy vấn cơ sở dữ liệu, truy xuất dữ liệu, và tích hợp với các dịch vụ bên thứ ba trực tiếp qua quy trình làm việc tương thích MCP. MCP GraphQL xử lý ánh xạ tham số công cụ, tạo JSON schema động, và xác thực (bao gồm Bearer, Basic hoặc header tùy chỉnh), hoàn toàn không cần định nghĩa schema thủ công. Mục tiêu chính của nó là đơn giản hóa quy trình phát triển bằng cách giúp API GraphQL dễ tiếp cận và có thể hành động cho trợ lý AI và người dùng thông qua một giao thức thống nhất.

Danh sách Prompt

Không có template prompt nào được đề cập trong tài liệu cung cấp.

Danh sách Resource

Không có tài nguyên MCP cụ thể nào được mô tả trong tài liệu.

Danh sách Công cụ

• Công cụ Truy vấn GraphQL
  Mỗi truy vấn GraphQL được phơi bày bởi API mục tiêu sẽ được trình bày như một công cụ MCP riêng biệt. Máy chủ tạo động một công cụ cho mỗi truy vấn, với các tham số công cụ khớp với tham số truy vấn GraphQL. Điều này cho phép client thực thi bất kỳ truy vấn nào mà API hỗ trợ trực tiếp qua MCP.
  • Tham số: Được tạo tự động từ schema GraphQL
  • Input schema: Được xây dựng động dựa trên yêu cầu của truy vấn

Tình huống sử dụng của máy chủ MCP này

• Quản lý cơ sở dữ liệu qua GraphQL
  Lập trình viên có thể chạy các truy vấn phức tạp tới cơ sở dữ liệu hỗ trợ GraphQL, lấy dữ liệu có cấu trúc trực tiếp vào môi trường phát triển hoặc quy trình AI của họ.
• Tích hợp API bên thứ ba
  Tích hợp liền mạch với các sản phẩm SaaS hoặc dịch vụ phơi bày endpoint GraphQL, cho phép trợ lý AI lấy, tổng hợp hoặc thao tác dữ liệu từ xa.
• Thử nghiệm nguyên mẫu và khám phá dữ liệu nhanh
  Kiểm tra ngay các truy vấn khả dụng từ một API GraphQL mới, cho phép thử nghiệm nhanh và phân tích dữ liệu mà không cần ánh xạ schema thủ công.
• Báo cáo tự động
  Sử dụng agent AI để tự động truy xuất dữ liệu từ API GraphQL và tổng hợp báo cáo hoặc bảng điều khiển theo yêu cầu.
• Quản lý file hoặc nội dung nâng cao
  Nếu một dịch vụ phơi bày khả năng quản lý file hoặc nội dung thông qua GraphQL, chúng có thể được truy cập như các công cụ để tự động hóa quy trình làm việc.

Cách thiết lập

Windsurf

1. Đảm bảo đã cài đặt Python 3.11+.
2. Cài đặt mcp-graphql qua pip hoặc dùng uvx nếu cần.
3. Sửa file cấu hình Windsurf của bạn.
4. Thêm máy chủ MCP GraphQL vào phần mcpServers:

   "mcpServers": {
     "graphql": {
       "command": "uvx",
       "args": ["mcp-graphql", "--api-url", "https://api.example.com/graphql"]
     }
   }
   

5. Lưu cấu hình và khởi động lại Windsurf.
6. Kiểm tra kết nối bằng cách chạy một truy vấn test.
7. Bảo mật khóa API: Sử dụng biến môi trường.

   "mcpServers": {
     "graphql": {
       "command": "uvx",
       "args": [
         "mcp-graphql",
         "--api-url", "https://api.example.com/graphql",
         "--auth-token", "${GRAPHQL_TOKEN}"
       ],
       "env": {
         "GRAPHQL_TOKEN": "your-token"
       }
     }
   }
   

Claude

1. Mở phần cài đặt/cấu hình của Claude.
2. Cài đặt hoặc đảm bảo có sẵn uvx hoặc mcp-graphql.
3. Thêm vào cấu hình mcpServers:

   "mcpServers": {
     "graphql": {
       "command": "uvx",
       "args": ["mcp-graphql", "--api-url", "https://api.example.com/graphql"]
     }
   }
   

4. Hoặc sử dụng pip hoặc Docker như sau:

   "mcpServers": {
     "graphql": {
       "command": "python",
       "args": ["-m", "mcp_graphql", "--api-url", "https://api.example.com/graphql"]
     }
   }
   

   hoặc

   "mcpServers": {
     "graphql": {
       "command": "docker",
       "args": ["run", "-i", "--rm", "mcp/graphql", "--api-url", "https://api.example.com/graphql"]
     }
   }
   

5. Lưu thay đổi và khởi động lại Claude để áp dụng.

Cursor

1. Cài đặt mcp-graphql bằng pip hoặc uvx.
2. Mở file cấu hình Cursor của bạn.
3. Thêm nội dung sau vào phần mcpServers:

   "mcpServers": {
     "graphql": {
       "command": "uvx",
       "args": ["mcp-graphql", "--api-url", "https://api.example.com/graphql"]
     }
   }
   

4. Lưu cấu hình và tải lại Cursor.
5. Kiểm tra bằng cách chạy một truy vấn mẫu thông qua giao diện MCP.

Cline

1. Đảm bảo bạn đã cài đặt Python 3.11+ và mcp-graphql.
2. Xác định vị trí file cấu hình của Cline.
3. Thêm máy chủ MCP GraphQL vào thiết lập mcpServers của bạn:

   "mcpServers": {
     "graphql": {
       "command": "uvx",
       "args": ["mcp-graphql", "--api-url", "https://api.example.com/graphql"]
     }
   }
   

4. Lưu và khởi động lại Cline.
5. Sử dụng biến môi trường cho token như hướng dẫn ở trên để đảm bảo bảo mật.

Bảo mật khóa API

Sử dụng biến môi trường cho các dữ liệu nhạy cảm như token:

"mcpServers": {
  "graphql": {
    "command": "uvx",
    "args": [
      "mcp-graphql",
      "--api-url", "https://api.example.com/graphql",
      "--auth-token", "${GRAPHQL_TOKEN}"
    ],
    "env": {
      "GRAPHQL_TOKEN": "your-token"
    }
  }
}

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 làm việc FlowHunt của bạn, hãy bắt đầu bằng cách thêm thành phần MCP vào flow và kết nối nó với agent AI của bạn:

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, chèn chi tiết máy chủ MCP của bạn bằng định dạng JSON sau:

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

Sau khi cấu hình, agent AI đã có thể sử dụng MCP này như một công cụ với đầy đủ chức năng và khả năng của nó. Hãy nhớ thay “graphql” bằng tên thực tế của máy chủ MCP của bạn và thay URL bằng địa chỉ MCP server của bạn.

Tổng quan

Một triển khai MCP thiết thực, chắc chắn cho API GraphQL, nhưng thiếu prompt/resource rõ ràng và không đề cập sampling hay root. Phù hợp cho phơi bày công cụ và dễ dàng thiết lập. Đánh giá 7/10 về độ hoàn thiện và hữu ích cho lập trình viên.

Điểm MCP