Skip to content

Conversation

blurrah
Copy link

@blurrah blurrah commented May 26, 2025

Background

This adds a blog post to introduce the mcp-graphql server.

Description

This is a blog post introducing the mcp-graphql server and what it does, why MCP and GraphQL work very well and it's future goals. This is a really early rough draft.

Checklist

Not needed for a blog post.

Copy link
Contributor

coderabbitai bot commented May 26, 2025

Important

Review skipped

Auto reviews are disabled on this repository.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

✨ Finishing touches
🧪 Generate unit tests
  • Create PR with unit tests
  • Post copyable unit tests in a comment

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.


TL;DR

- The GraphQL MCP server allows your AI models to interact with your GraphQL server
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Maybe worth mentioning in as many places as possible, that this works with ANY GraphQL server and you don't and shouldn't need any vendor specific solution in general

With traditional MCP servers, this would require separate tools for users, posts, filtering, and sorting - if you even anticipated this exact combination.

## The future
- Tools per operation
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Turn that into text
also maybe link to PRs or issues on the repo
and expand more on the idea of how to connect to Hive Console


You can track progress for it on [this PR](https://github.com/blurrah/mcp-graphql/pull/3)

Will also support persisted documents in the future allowing you to work with production API's that lock down calls
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Will also support persisted documents in the future allowing you to work with production API's that lock down calls
This feature will also support [persisted documents](https://the-guild.dev/graphql/hive/docs/schema-registry/app-deployments) in the future, allowing you to work with production API's that lock down calls.

Minor grammar changes and link to our trusted docs implementation for clarification on what persisted docs are and how to use them.

You can track progress for it on [this PR](https://github.com/blurrah/mcp-graphql/pull/3)

Will also support persisted documents in the future allowing you to work with production API's that lock down calls

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

a small conclusion or call to action is appropriate.
E.g. If you're interested in contributing to the mcp-graphql project or want to learn more, then ...

---
title: 'Introducing: GraphQL MCP server'
authors: blurrah
tags: [graphql, mcp]
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
tags: [graphql, mcp]
tags: [graphql, ai]

If we want to limit the number of tags, ai would be better to use than mcp since we can attribute more articles to that.

title: 'Introducing: GraphQL MCP server'
authors: blurrah
tags: [graphql, mcp]
date: 2025-05-26
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
date: 2025-05-26
date: 2025-09-26

adjust date since we're slow at approving

- You can access it at [github.com/blurrah/mcp-graphql](https://github.com/blurrah/mcp-graphql)

------
Most MCP servers force you to create narrow, specific tools for each API endpoint. Want to query user data? One tool. Need to fetch posts? Another tool. Want to combine users and their posts? You're out of luck unless you anticipated that exact use case.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Most MCP servers force you to create narrow, specific tools for each API endpoint. Want to query user data? One tool. Need to fetch posts? Another tool. Want to combine users and their posts? You're out of luck unless you anticipated that exact use case.
Most Model Context Protocol (MCP) servers force you to create narrow, specific tools for each API endpoint. Want to query user data? One tool. Need to fetch posts? Another tool. Want to combine users and their posts? You're out of luck unless you anticipated that exact use case.

it's nice to say what it is before using acronym.

@jdolle
Copy link
Collaborator

jdolle commented Sep 25, 2025

@blurrah sorry for the delay in reviewing this. We're still very interested in getting this posted.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Development

Successfully merging this pull request may close these issues.

3 participants