mcpaps (Yonathangc)

带Gemini集成的FastMCP控制器

🚀 项目概述

该脚本为连接到FastMCP服务器提供了基础，并利用Google Gemini API自动执行连接应用程序上的操作。它允许发送命令、读取实时状态和管理应用程序模块。

该项目的结构与GitHub Copilot和Roo code等代码建议工具兼容。

✅ 需求

• Python 3.7+
• pip（Python包安装程序）
• Google Gemini API密钥
• 访问FastMCP服务器（包括其URL和任何必要的身份验证令牌）

🔑 如何生成Gemini API密钥

1. 首选 谷歌人工智能工作室 （或Gemini API的相关谷歌云控制台页面）。
2. 使用您的Google帐户登录。
3. 创建一个新的API密钥。
4. 重要：复制此密钥并确保其安全。您将需要它 .env 文件。

🛠️ 安装说明

1. 克隆存储库（如果适用）或下载文件：

   # If it's a git repository
   git clone 
   cd 

   # If you downloaded files, navigate to the main project directory (e.g., fastmcp_controller)
   cd fastmcp_controller

1. 创建虚拟环境（推荐）：

   python -m venv venv

激活它：

- 窗户：

     .\venv\Scripts\activate

- macOS/Linux：

     source venv/bin/activate

1. 安装依赖项：

   pip install -r requirements.txt

1. 设置环境文件：

- 重命名 .env.example 向 .env.

     # In the fastmcp_controller directory
     cp .env.example .env

- 打开 .env 归档并填写您的详细信息：

     GEMINI_API_KEY="YOUR_GEMINI_API_KEY_HERE"
     FASTMCP_SERVER_URL="YOUR_FASTMCP_SERVER_URL_HERE" # e.g., ws://localhost:8080 or http://localhost:8080/api
     FASTMCP_AUTH_TOKEN="YOUR_FASTMCP_AUTH_TOKEN_HERE" # Optional, if your server requires it

▶️ 如何运行脚本

1. 确保您的虚拟环境已激活，并且您的 .env 文件配置正确。
2. 导航到 fastmcp_controller 目录（如果您还没有的话）。
3. 运行主脚本：

   python main.py

1. 按照屏幕上的提示操作或按设计与应用程序交互。

⚙️ 项目结构

• main.py：初始化连接和编排操作的主脚本。
• gemini_client.py：用于与Google Gemini API交互的模块。
• app_controller.py：用于通过FastMCP管理和与应用程序交互的模块。
• requirements.txt：列出Python依赖项。
• .env.example：环境变量模板。
• README.md：这个文件。

💡 兼容性

该项目的设计考虑了GitHub Copilot和Roo Code的兼容性，其特点是：

• 清晰、有注释的代码。
• 模块化结构。
• 键入提示（逐步添加）。

______________________________________________________________________

*这是一个基础脚本。您需要为FastMCP服务器实现特定的API调用和逻辑。*