mcp-graphql-forge

概述

MCP GraphQL Forge 是一个专业的 MCP 服务器，通过从 GraphQL 模型内省自动生成 MCP 工具，将 GraphQL API 与 AI 工具连接起来。它支持双传输模式（stdio 用于 AI 集成，HTTP 用于开发），全面的参数验证可防止 GraphQL 错误，以及智能字段选择系统，可处理循环引用并优化查询结构。该服务器支持预内省和模型缓存以确保性能一致，同时提供实验性认证支持。

试试问 AI

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

• query_user

  Execute GraphQL query to retrieve a user by ID

  试试:Get user with ID 123试试:Fetch user details for user@example.com
• query_articles

  Execute GraphQL query to retrieve articles with optional filters

  试试:List all articles试试:Get articles filtered by category 'technology'
• mutation_createUser

  Execute GraphQL mutation to create a new user

  试试:Create a new user with name John Doe试试:Add user to the system with email user@example.com
• query_posts

  Execute GraphQL query to retrieve blog posts with optional filters

  试试:Get all published posts试试:Fetch posts by author ID 456
• query_post

  Execute GraphQL query to retrieve a single post by slug

  试试:Get post with slug 'getting-started'试试:Fetch the post titled 'Introduction'
• query_authors

  Execute GraphQL query to retrieve all authors

  试试:List all authors试试:Get all author information
• mutation_createPost

  Execute GraphQL mutation to create a new blog post

  试试:Create a new post titled 'Hello World'试试:Add blog post with content about MCP servers
• mutation_publishPost

  Execute GraphQL mutation to publish a post by ID

  试试:Publish post with ID 789试试:Make post with ID 123 publicly visible
• query_products

  Execute GraphQL query to retrieve products with optional filters

  试试:List all available products试试:Get products in category 'electronics'
• mutation_productCreate

  Execute GraphQL mutation to create a new product

  试试:Add a new product 'Wireless Headphones'试试:Create product with SKU 12345
• query_orders

  Execute GraphQL query to retrieve orders with optional filters

  试试:List all recent orders试试:Get orders for customer ID 456
• mutation_orderUpdate

  Execute GraphQL mutation to update an existing order

  试试:Update order 789 with new shipping address试试:Change payment method for order 456

可对比工具

安装

npx @smithery/cli install @toolprint/mcp-graphql-forge --client claude

# npm install
npm install -g @toolprint/mcp-graphql-forge

{
  "mcpServers": {
    "mcp-graphql-forge": {
      "command": "npx",
      "args": [
        "-y",
        "@toolprint/mcp-graphql-forge"
      ],
      "env": {
        "GRAPHQL_ENDPOINT": "https://your-api.com/graphql",
        "GRAPHQL_AUTH_HEADER": "Bearer YOUR_TOKEN"
      }
    }
  }
}

FAQ

它如何处理 GraphQL 内省？

服务器会自动内省 GraphQL API 以生成工具。您可以使用 'introspect' 命令预生成并缓存模型，以加快启动速度。

它是否支持认证？

是的，它支持通过环境变量（如 GRAPHQL_AUTH_HEADER）进行认证。可以使用 GRAPHQL_HEADER_* 前缀配置自定义标头。

mcp-graphql-forge 对比