Bloom Growth

🚀 鮮花 MCP 服務器

鮮花 MCP 服務器是一個用於與 Bloom Growth 的 GraphQL API 進行交互的模型上下文協議（MCP）服務器，它能讓人工智能助手在 Bloom Growth 平臺上執行各類操作，為用戶提供便捷的交互體驗。

🚀 快速開始

鮮花 MCP 是一個連接到 Bloom Growth 的 GraphQL API 並通過 Model Context Protocol（MCP，模型上下文協議）進行暴露的服務器，使人工智能助手能夠對 Bloom Growth 平臺執行操作。

✨ 主要特性

• 通過 MCP 查詢 Bloom Growth 的 GraphQL API
• 獲取查詢和突變的詳細信息
• 通過 MCP 工具執行 GraphQL 查詢和突變
• 獲取已認證用戶的詳細信息
• 自動化模式探查

📦 安裝指南

先決條件

• Python 3.12 或更高版本
• 對 Bloom Growth API 的訪問權限
• uv（推薦）或 pip 用於包管理

包管理

此項目建議使用 uv，這是一個快速的 Python 包安裝程序和解析器，可作為 pip/pip-tools 的 drop-in 替代品。它的速度顯著快於傳統的包管理工具。

安裝 uv

curl -sSf https://astral.sh/uv/install.sh | sh

如需其他安裝方法，請參考 uv 文檔。

設置步驟

1. 克隆此倉庫
2. 設置 Python 虛擬環境：

   python -m venv .venv
   source .venv/bin/activate  # 在 Windows 上：.venv\Scripts\activate
   

3. 開發模式下安裝包：
   • 使用 pip：

   pip install -e .
   

   • 使用 uv（推薦）：

   uv pip install -e .
   

   • 安裝開發依賴項：

   uv pip install -e ".[dev]"
   

環境變量

創建一個 .env 文件，包含以下變量：

BLOOM_API_URL=<你的 Bloom API URL>
BLOOM_API_TOKEN=<你的 Bloom API Token>

💻 使用示例

光標集成

要將此 MCP 服務器與 Cursor（AI 驅動的 IDE）集成：

1. 進入 Cursor > Cursor 設置 > MCP
2. 點擊“添加新的 MCP 服務器”
3. 配置服務器如下：
   • 名稱： "Bloom Growth"（或其他你喜歡的名字）
   • 類型： 命令
   • 命令： uv run --project /path/to/your/repo/ --env-file /path/to/your/repo/.env 鮮花-server

注意將 /path/to/your/repo/ 替換為實際倉庫路徑。

MCP 服務器運行

1. 確保已安裝 Python 並且版本滿足要求
2. 激活虛擬環境（如果使用）
3. 執行命令：

uv run 鮮花-server

📚 詳細文檔

鮮花 MCP 服務器的源代碼託管在 GitHub，歡迎提交問題和拉取請求。