A high-performance Python HTTP server for GraphQL APIs with built-in authentication, CORS, and GraphiQL integration.

GraphQL HTTP for Python #

Why GraphQL HTTP? #

graphql-http provides a production-ready HTTP server for your GraphQL APIs, built on Starlette/ASGI for excellent async performance. It handles authentication, CORS, health checks, and includes an integrated GraphiQL interface for development.

Key Features #

Feature	Description
🚀 High Performance	Built on Starlette/ASGI for excellent async performance, handling thousands of concurrent requests.
🔐 JWT Authentication	Built-in JWT authentication with JWKS support for secure GraphQL APIs in production.
🌐 CORS Support	Configurable CORS middleware for seamless cross-origin requests.
🎨 GraphiQL Integration	Interactive GraphQL IDE included for easy development and testing.
📊 Health Checks	Built-in health check endpoints for monitoring and orchestration.
🔄 Batch Queries	Support for batched GraphQL operations to optimize network usage.

Quick Start #

Installation #

pip install graphql-http

Basic Usage #

from graphql import GraphQLSchema, GraphQLObjectType, GraphQLField, GraphQLString
from graphql_http import GraphQLHTTP

# Define your GraphQL schema
schema = GraphQLSchema(
    query=GraphQLObjectType(
        name="Query",
        fields={
            "hello": GraphQLField(
                GraphQLString,
                resolve=lambda obj, info: "Hello, World!"
            )
        }
    )
)

# Create the HTTP server
app = GraphQLHTTP(schema=schema)

# Run the server
if __name__ == "__main__":
    app.run(host="0.0.0.0", port=8000)

Visit http://localhost:8000/graphql to access the GraphiQL interface.

graphql-http provides HTTP serving for GraphQL APIs. For additional functionality:

Schema Building: graphql-api #

Build GraphQL schemas with a decorator-based approach using graphql-api:

from graphql_api import GraphQLAPI
from graphql_http import GraphQLHTTP

api = GraphQLAPI()

@api.type(is_root_type=True)
class Query:
    @api.field
    def hello(self, name: str = "World") -> str:
        return f"Hello, {name}!"

# Create HTTP server from API
server = GraphQLHTTP.from_api(api)
server.run()

Learn more: graphql-api documentation

Database Integration: graphql-db #

For database-backed APIs, use graphql-db with graphql-http:

from graphql_api import GraphQLAPI
from graphql_http import GraphQLHTTP
from graphql_db.orm_base import DatabaseManager

db_manager = DatabaseManager(url="sqlite:///myapp.db")
api = GraphQLAPI()
# ... define your schema with database models ...

server = GraphQLHTTP.from_api(api)
server.run()

Learn more: graphql-db documentation

MCP Tools: graphql-mcp #

Expose your GraphQL API as MCP tools alongside HTTP with graphql-mcp:

from graphql_api import GraphQLAPI
from graphql_mcp.server import GraphQLMCP

api = GraphQLAPI()
# ... define your schema ...

# Serve both MCP and GraphQL HTTP
server = GraphQLMCP.from_api(api, graphql_http=True)
app = server.http_app()

Learn more: graphql-mcp documentation

What’s Next? #

📚 Getting Started - Learn the basics with our comprehensive guide
💡 Examples - Explore practical examples and tutorials for real-world scenarios
📖 API Reference - Check out the complete API documentation