MCP Nhost

🚀 mcp-nhost

mcp-nhost是一個用於與Nhost雲項目和服務交互的模型上下文協議（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服務器在設計時考慮了安全性，提供了現有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，請運行以下命令：

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

路線圖

已完成功能

• 安全保護層
• 精細訪問控制
• 項目配置支持

計劃功能

• 支持更多雲提供商
• 增強的錯誤處理
• 自動化文檔生成

如有任何建議或功能請求，請隨時打開問題進行討論。

🤝 貢獻

我們歡迎為mcp-nhost做貢獻！如果您有任何建議、問題報告或功能請求，請隨時打開問題或提交拉取請求。

感謝您的支持與合作！