Graphql Api Integration

🚀 mcp-graphql項目文檔

mcp-graphql是一個支持大語言模型（LLMs）與GraphQL API交互的Model Context Protocol服務器。它提供了模式introspection和查詢執行功能，能讓模型動態發現和使用GraphQL API。

🚀 快速開始

使用mcp-graphql命令時指定正確的端點，它會自動嘗試introspection查詢。

📦 安裝指南

使用Smithery安裝

要通過Smithery自動安裝GraphQL MCP Server for Claude Desktop，可執行以下命令：

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查詢生成的。

🔧 技術細節

mcp-graphql是一個通用的實現，允許完整的introspection，並讓用戶能夠執行任意操作（包括變異）。如果需要更具體的實現，建議創建自定義的MCP，並限制客戶端工具調用僅限於特定查詢字段和/或變量，此項目可作為參考。

⚠️ 重要提示

變異操作默認關閉，作為安全措施。在生產環境中啟用變異操作前請謹慎考慮。