MCP Nhost

MCP-Nhost is a protocol server that provides a unified management interface for Nhost cloud projects. It supports operations such as project configuration, data query, and permission management through GraphQL, and also has local development support functions.

Developer tools Cloud platform #Cloud project management #GraphQL interface #Local development #Permission control .Go

rating : 2.5 points

downloads : 13

update time : 2025-04-28

What is MCP-Nhost?

MCP-Nhost is an intermediate layer service that provides a unified management interface for Nhost cloud projects through the standardized Model Context Protocol. It simplifies the interaction process with various Nhost services, enabling developers to more easily manage project configurations, execute GraphQL queries, and manage permissions.

How to use MCP-Nhost?

After installing MCP-Nhost, you can access its functions through a simple command-line tool or a configured client (such as Cursor). It provides various tools to query and manage all aspects of Nhost projects.

Use cases

MCP-Nhost is particularly suitable for teams that need to centrally manage multiple Nhost projects or developers who want to integrate Nhost management functions into their development process. It is also applicable to scenarios that require fine-grained control over GraphQL query permissions.

Main features

Cloud platform managementProvides complete management capabilities for Nhost cloud platform projects, including querying organization, project, and configuration information

Local development supportSupports configuration management and GraphQL query execution for local Nhost development projects

Schema awarenessCan obtain and parse the GraphQL schema to help developers understand available operations

Migration managementCreate and apply database migrations, manage Hasura metadata and permissions

Documentation searchBuilt-in search function for Nhost official documentation to quickly find relevant resources and guides

Fine-grained access controlAllows precise specification of which GraphQL operations can be executed through the MCP server

Advantages and limitations

Advantages

Provides a unified interface to simplify Nhost project management

Enhanced security layer beyond basic GraphQL permission control

Supports unified management of local and cloud projects

Fine-grained operation permission control to improve security

Built-in documentation search to accelerate problem-solving

Limitations

Requires additional installation and configuration

Local configuration changes require restarting the Nhost service to take effect

Some advanced features require specific permissions

Learning curve for users unfamiliar with the MCP protocol

How to use

Installation

Install MCP-Nhost using the provided installation script

Configuration

Run the configuration command to set your Nhost project access permissions

Start the server

Start the MCP server to begin using its functions

Configure the client (such as Cursor)

Add the MCP server configuration to your preferred development tool

Usage examples

Query cloud project informationUse MCP-Nhost to query information about your projects on the Nhost cloud platform

Local development queryExecute GraphQL queries in the local development environment

Create a database migrationCreate a new database migration for a local project

Search documentationSearch the Nhost official documentation when encountering problems

Frequently Asked Questions

What is the difference between MCP-Nhost and directly using the Nhost CLI?

How to allow specific GraphQL mutation operations?

Why don't my local configuration changes take effect immediately?

How to get help or report issues?

Does MCP-Nhost support team collaboration features?

Related resources

Official GitHub repository

Project source code and issue tracking

Nhost official documentation

Complete documentation for the Nhost platform

MCP protocol description

Official description of the Model Context Protocol

Installation guide

Detailed installation and configuration instructions

Usage examples

More usage examples and scenarios

🚀 mcp-nhost

An implementation of the Model Context Protocol (MCP) server for interacting with Nhost cloud projects and services.

🚀 Quick Start

MCP-Nhost aims to provide a unified interface for managing Nhost cloud projects through the Model Context Protocol. It enables you to seamlessly interact with Nhost cloud services and offers a powerful set of tools for project management and configuration.

✨ Features

Available Tools

The following tools are currently exposed through the MCP interface:

cloud_get_graphql_schema
- Provides the GraphQL schema of the Nhost cloud platform.
- Allows you to access queries and mutations for cloud management.
- Obtains information about available queries and mutations.
cloud_graphql_query
- Executes GraphQL queries and mutations against the Nhost cloud platform.
- Implements project and organization management.
- Allows querying and updating project configurations.
- Mutations need to be enabled when starting the server.
local_get_graphql_schema
- Retrieves the GraphQL schema of a local Nhost development project.
- Enables you to access project-specific queries and mutations.
- Helps generate code to understand available operations.
- Uses the "user" role by default, unless otherwise specified.
local_graphql_query
- Executes GraphQL queries against a local Nhost development project.
- Allows you to test and develop project-specific operations.
- Supports query and mutation operations.
- Uses the "user" role by default, unless otherwise specified.
local_get_possible_query mutations
- Gets information about available queries and mutations.
- Displays query and mutation options for the current project.
- Helps you understand project functionality.
- Provides clear and structured output.

📦 Installation

To install mcp-nhost, run the following commands:

git clone https://github.com/your-username/mcp-nhost.git
cd mcp-nhost
cargo install --path .

📚 Documentation

Configuration

In the config.toml file, you can specify allowed queries and mutations. For example:

[[projects]]
subdomain = "my-blog"
region = "eu-central-1"
pat = "your_project_access_token"
allow_queries = ["getPost", "getComments"]
allow_mutations = ["insertPost", "insertComment"]

Client Configuration

For Cursor, add the following to config.toml:

[["projects"]]
  subdomain = "my-blog"
  region = "eu-central-1"
  pat = "your_project_access_token"
  allow_queries = ["getPost", "getComments"]
  allow_mutations = ["insertPost", "insertComment"]

CLI Usage

Run the following command to see how to use the CLI:

mcp-nhost --help

🚧 Roadmap

Completed Features

Security protection layer
Fine-grained access control
Project configuration support

Planned Features

Support for more cloud providers
Enhanced error handling
Automated documentation generation

If you have any suggestions or feature requests, feel free to open an issue for discussion.

🔒 Security and Privacy

Enhanced Protection Layer

The MCP server is designed with security in mind, providing an additional layer of protection beyond existing GraphQL permissions. Key security features include:

Mandatory authentication for all requests.
Respect for roles and permissions based on your existing authorization system and provided credentials.
Query/mutation filtering to further restrict allowed operations.

Fine-grained Access Control

A key security advantage of the MCP server is the ability to precisely specify allowed operations, even for users with broader project permissions:

[[projects]]
subdomain = "my-blog"
region = "eu-central-1"
pat = "nhp_project_specific_pat"
allow_queries = ["getBlogs", "getComments"]
allow_mutations = ["insertBlog", "insertComment"]

With the above configuration, the LLM can only execute specified queries and mutations when the user has broader permissions.

🤝 Contribution

We welcome contributions to mcp-nhost! If you have any suggestions, issue reports, or feature requests, feel free to open an issue or submit a pull request.

Thank you for your support and collaboration!