MCP Catalogs
首页

mcp-graphql

by blurrah·385·综合分 47

MCP 服务器使 LLM 能够通过模式内省和查询执行与 GraphQL API 交互。

developer-toolsai-llmweb-scraping
58
Forks
14
活跃 Issue
8 个月前
最近提交
2 天前
收录于

概述

这个 MCP 服务器为大型语言模型与 GraphQL API 交互提供了一个强大的接口。它自动尝试内省 GraphQL 模式并执行查询,默认情况下禁用变更操作以确保安全性。服务器可以使用本地模式文件、远程模式 URL 或运行时内省查询,使其适用于各种 GraphQL 实现。

试试问 AI

装完之后,这里有 5 个你可以让 AI 做的事:

:使 AI 助手能够查询 GraphQL API 而无需自定义实现
:允许语言模型发现和交互未知的 GraphQL 服务
:为 AI 应用程序提供对 GraphQL 端点的安全只读访问
:GraphQL 变更操作默认是否启用?
:我可以使用本地模式文件代替内省吗?

什么时候选它

当您需要将大模型连接到GraphQL API并希望具有受控查询访问的模式内省能力时,选择mcp-graphql。

什么时候不要选它

如果您需要基本标头之外的高级身份验证机制,或者您正在使用非GraphQL的REST API,请不要选择它。

此 server 暴露的工具

从 README 抽取出 2 个工具
  • introspect-schema

    Retrieves the GraphQL schema using introspection or local/schema file.

  • query-graphql

    Execute GraphQL queries against the endpoint.

可对比工具

rest-api-mcpapi-mcpgraphql-client

安装

通过 Smithery 安装

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

手动安装 (Claude Desktop)

将以下内容添加到您的 Claude Desktop 配置中:

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

环境变量

  • ENDPOINT: GraphQL 端点 URL(默认:http://localhost:4000/graphql)
  • HEADERS: 包含请求头的 JSON 字符串
  • ALLOW_MUTATIONS: 启用变更操作(默认禁用)
  • NAME: MCP 服务器名称
  • SCHEMA: 本地 GraphQL 模式文件路径或 URL(可选)

FAQ

GraphQL 变更操作默认是否启用?
不,变更操作默认禁用,这是作为安全措施防止 LLM 修改您的数据库或服务数据。您必须通过设置 ALLOW_MUTATIONS=true 来明确启用它们。
我可以使用本地模式文件代替内省吗?
是的,您可以使用 SCHEMA 环境变量指定本地模式文件路径,或提供远程模式文件的 URL。

mcp-graphql 对比

GitHub →

最后更新于 · 由 README + GitHub 公开数据自动生成。