MCP Nhost

🚀 mcp - nhost

このプロジェクトは、Nhostクラウドプロジェクトとサービスとの相互作用を行うためのモデルコンテキストプロトコル（MCP）サーバーの実装です。MCP - Nhostを使用することで、Nhostクラウドサービスを円滑に操作し、プロジェクトの管理と設定が可能になります。

🚀 クイックスタート

MCP - Nhostは、モデルコンテキストプロトコルを通じてNhostクラウドプロジェクトの管理を行うための統一インターフェースを提供します。これにより、Nhostクラウドサービスとの相互作用が容易になり、プロジェクトの管理や設定に必要な強力なツールを利用できます。

✨ 主な機能

利用可能なツール

現在、MCPインターフェースを通じて公開されているツールは以下の通りです。

1. cloud_get_graphql_schema
   • NhostクラウドプラットフォームのGraphQLスキーマを提供します。
   • クラウド管理に使用するクエリとミューテーションにアクセスできます。
   • 利用可能なクエリとミューテーションに関する情報を取得できます。
2. cloud_graphql_query
   • Nhostクラウドプラットフォームに対するGraphQLクエリとミューテーションを実行します。
   • プロジェクトと組織の管理を実現します。
   • プロジェクトの設定をクエリおよび更新できます。
   • ミューテーションはサーバー起動時に有効にする必要があります。
3. local_get_graphql_schema
   • ローカルのNhost開発プロジェクトのGraphQLスキーマを取得します。
   • プロジェクト固有のクエリとミューテーションにアクセスできます。
   • 利用可能な操作を理解するためのコード生成を支援します。
   • 特に指定がない限り、デフォルトで「ユーザー」ロールを使用します。
4. local_graphql_query
   • ローカルのNhost開発プロジェクトに対するGraphQLクエリを実行します。
   • プロジェクト固有の操作をテストおよび開発できます。
   • クエリとミューテーション操作をサポートします。
   • 特に指定がない限り、デフォルトで「ユーザー」ロールを使用します。
5. local_get_possible_query mutations
   • 利用可能なクエリとミューテーションに関する情報を取得します。
   • 現在のプロジェクトのクエリとミューテーションオプションを表示します。
   • プロジェクトの機能を理解するのに役立ちます。
   • 明確な構造化された出力を提供します。

📦 インストール

mcp - nhostをインストールするには、以下のコマンドを実行してください。

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

📚 ドキュメント

設定

config.tomlファイルで、許可するクエリとミューテーションを指定できます。例えば：

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

クライアント設定

Cursorの場合、config.tomlに以下の内容を追加してください。

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

CLIの使用

CLIの使用方法を確認するには、以下のコマンドを実行してください。

mcp - nhost --help

ロードマップ

完了した機能

• セキュリティ保護層
• 細かいアクセス制御
• プロジェクト設定のサポート

計画されている機能

• より多くのクラウドプロバイダーのサポート
• 強化されたエラー処理
• 自動化されたドキュメント生成

ご提案や機能リクエストがある場合は、自由にIssueを開いて議論してください。

セキュリティとプライバシー

強化された保護層

MCPサーバーはセキュリティを考慮して設計されており、既存のGraphQL権限に加えて追加の保護層を提供します。主要なセキュリティ機能は以下の通りです。

• すべてのリクエストに対する強制認証
• 既存の認可システムと提供された資格情報に基づく、ロールと権限の尊重
• 許可される操作をさらに制限するクエリ/ミューテーションフィルタリング

細かいアクセス制御

MCPサーバーの重要なセキュリティ上の利点は、より広範なプロジェクト権限を持つユーザーであっても、通過を許可する操作を正確に指定できることです。

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

上記の設定により、LLMはユーザーがより広範な権限を持っている場合でも、指定されたクエリとミューテーション操作のみを実行できます。

🔧 貢献

mcp - nhostへの貢献を歓迎します！ご提案、問題報告、または機能リクエストがある場合は、自由にIssueを開いたり、Pull Requestを送信してください。

ご支援と協力ありがとうございます！