Graphql MCP Toolkit

🚀 mcp-graphql

一個使大語言模型（LLM）能夠與GraphQL API交互的模型上下文協議服務器。此實現提供模式內省（introspection）和查詢執行功能，允許模型動態發現和使用GraphQL API。

🚀 快速開始

運行 mcp-graphql 時指定正確的端點，它將自動嘗試內省（introspect）你的查詢。

📦 安裝指南

通過Smithery安裝

要通過 Smithery 自動安裝 GraphQL MCP 工具包：

npx -y @smithery/cli install mcp-graphql --client claude

手動安裝

可以手動安裝到Claude：

{
  "mcpServers": {
    "mcp-graphql": {
      "command": "npx",
      "args": ["mcp-graphql", "--endpoint", "http://localhost:3000/graphql"]
    }
  }
}

💻 使用示例

基礎用法

# 基本使用方法，與本地GraphQL服務器一起使用
npx mcp-graphql --endpoint http://localhost:3000/graphql

高級用法

# 使用自定義頭
npx mcp-graphql --endpoint https://api.example.com/graphql --headers '{"Authorization":"Bearer token123"}'

# 啟用突變操作
npx mcp-graphql --endpoint http://localhost:3000/graphql --enable-mutations

# 使用本地模式文件而不是內省（introspection）
npx mcp-graphql --endpoint http://localhost:3000/graphql --schema ./schema.graphql

✨ 主要特性

命令行參數

可用工具

服務器提供兩個主要工具：

1. introspect-schema：此工具檢索GraphQL模式。如果你沒有訪問模式資源的權限，請先使用此工具。這將使用本地模式文件或基於內省（introspection）查詢。
2. query-graphql：對端點執行GraphQL查詢。默認情況下禁用突變操作，除非指定 --enable-mutations。

資源

• graphql-schema：服務器公開GraphQL模式作為資源，供客戶端訪問。這是本地模式文件或基於內省（introspection）查詢的結果。

📚 詳細文檔

安全注意事項

突變默認禁用，作為安全措施，以防止大語言模型（LLM）修改你的數據庫或服務數據。在生產環境中啟用突變操作時請謹慎考慮。

自定義自己的服務器

這是一個非常通用的實現，允許完全內省（introspection）並且允許用戶執行任何操作（包括突變）。如果你需要更特定的實現，建議創建你自己的MCP，並限制客戶端調用工具以僅輸入特定的查詢字段和/或變量。你可以以此為參考。