鲜花 MCP 服务器

一个用于与 Bloom Growth 的 GraphQL API 进行交互的模型上下文协议（MCP）服务器。

概述

鲜花 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，欢迎提交问题和拉取请求。

完整翻译说明：

1. 保持原文技术术语，如 MCP、GraphQL 等，并在首次出现时添加中文注释。
2. 将代码块中的命令和文件路径用中文语境重新表达，确保可读性。
3. 保留英文变量名（如 BLOOM_API_URL），并在上下文中用中文描述。
4. 检查并调整段落结构，使翻译后的内容流畅自然。

如有任何问题或需要进一步说明，请随时告知。