toolprint/mcp-graphql-forge

Developer tools 公式

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。原文を見る

18 stars 6 forks 品質 57 トレンド 22NOASSERTION

Repository Install

GraphQL API をプロキシし、mcp ツールとして graphql 操作を公開できる MCP.

概要

GraphQL API をAI ツールへアクセスできる MCP サーバー: - グラフQL スキーマのイントロスペクションから MCP ツールを自動的に生成 - パラメータの検証と信頼性の高い AI インタラクションのエラーの処理 - 開発と生産のための stdio と HTTP トランスポートの双方をサポート - スキーマとフィールドセレクションをキャッシュし、一貫したパフォーマンスを実現します - : グラフQL スキーマのイントロスペクションから MCP ツールを作成します。 : 多層バリデーションは GraphQL エラーを防止します。 : stdio (AI ツール) と HTTP (開発/テスト) - : オプションの事前イントロスペクションとキャッシュ - : 認証エンドポイントの柔軟なヘッダ構成 [実験] : Dockerランタイムのサポートは現在進行中です。生産展開では、SmiseryのようなプラットフォームでTypeScriptランタイムを使用することをお勧めします。プロジェクトルートでmcp.jsonを作成します。これはモードで実行されます.

概要（AI 翻訳）

クイックインストール

代替インストール方法

GraphQL API を AI ツールへアクセスできる MCP サーバー:

グラフQL スキーマイントロスペクションから MCP ツールを自動的に生成
信頼できるAIの相互作用のための変数そして処理の間違いの検証
開発および生産のためのstdioおよびHTTPの輸送を支えて下さい
一貫した性能のためのスキーマおよび分野の選択をキャッシュして下さい

✨ 機能

用具の生成: グラフQL スキーマのイントロスペクションから MCP ツールを作成する -Parameter Validation: 多層バリデーションにより、GraphQL エラーを防ぎます。 -Dual Transport: stdio(AIツール)とHTTP(開発/テスト)をサポート
シェマ管理: 任意前点検およびキャッシュ -Authentication: 認証エンドポイントの柔軟なヘッダ構成 [Experimental]

OST 始める

**注記: Dockerランタイムのサポートは現在進行中です。生産展開では、SmiseryのようなプラットフォームでTypeScriptランタイムを使用することをお勧めします。

クイックスタート(開発におすすめ)

1.サーバの起動:

2.MCPインスペクタとの接続:

3.認証付き:

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。

README

以下は原文 README の抜粋です。原文を見る。

MCP GraphQL Forge

Quick Install

Alternative Installation Methods

# Via Smithery (recommended)
npx @smithery/cli install @toolprint/mcp-graphql-forge --client claude

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

An MCP server that makes GraphQL APIs accessible to AI tools by:

Automatically generating MCP tools from GraphQL schema introspection
Validating parameters and handling errors for reliable AI interactions
Supporting both stdio and HTTP transports for development and production
Caching schema and field selections for consistent performance

✨ Features

Tool Generation: Creates MCP tools from GraphQL schema introspection
Parameter Validation: Multi-layer validation prevents GraphQL errors
Dual Transport: Supports stdio (AI tools) and HTTP (development/testing)
Schema Management: Optional pre-introspection and caching
Authentication: Flexible header configuration for authenticated endpoints [Experimental]

🚀 Getting Started

Note: Docker runtime support is currently a work in progress. For production deployments, we recommend using the TypeScript runtime on platforms like Smithery.

Quick Start with HTTP Mode (Recommended for Development)

Start the server:

# Start serving it with the Streamable HTTP transport
GRAPHQL_ENDPOINT="https://your-api.com/graphql" npx -y @toolprint/mcp-graphql-forge --transport http --port 3001

Connect with MCP Inspector:

# In another terminal, launch the inspector
npx @modelcontextprotocol/inspector

With authentication:

# Using environment variables for configuration
export GRAPHQL_ENDPOINT="https://api.github.com/graphql"
export GRAPHQL_AUTH_HEADER="Bearer YOUR_TOKEN"
npx @toolprint/mcp-graphql-forge --transport http --port 3001

# Or all in one line
GRAPHQL_ENDPOINT="https://api.github.com/graphql" GRAPHQL_AUTH_HEADER="Bearer YOUR_TOKEN" npx @toolprint/mcp-graphql-forge --transport http --port 3001

Direct AI Integration (Claude/Cursor)

GitHub で README 全文を見る

インストール

npx -y @toolprint/mcp-graphql-forge

MCP 初心者？mcpskill.org のガイドから始めましょう →

設定

{
    "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"
            }
        }
    }
}