MCP Gemini Server

MCP Gemini Server

site icon
2025.03.17 0
PythonAI辅助文本生成文本分析聊天对话开发效率内容生成
MCP Gemini Server 是一个实现了模型上下文协议(MCP)的服务器,旨在使AI助手(如Claude)能够与Google的Gemini API进行交互。该服务器支持文本生成、文本分析以及聊天对话等功能,适用于需要AI辅助内容生成和分析的场景。
View on GitHub

Overview

基本能力

产品定位

MCP Gemini Server 是一个中间件服务器,通过实现模型上下文协议(MCP),为AI助手提供与Google Gemini API交互的能力。

核心功能

  • 客户端-服务器通信:实现MCP协议,确保客户端与服务器之间的安全消息交换。
  • 消息处理:处理客户端请求并返回适当的响应。
  • 错误处理与日志记录:记录服务器活动并确保错误恢复。
  • 环境变量支持:使用.env文件安全存储敏感信息。
  • API测试与调试:支持通过Postman和测试脚本进行手动和自动化测试。

适用场景

  • 内容生成:如生成诗歌、故事等文本内容。
  • 文本分析:包括情感分析、摘要生成和关键词提取。
  • 聊天对话:与Gemini模型进行多轮对话。

工具列表

  • Postman:用于手动测试API端点。
  • test_client.py:用于自动化测试不同功能(文本生成、文本分析、聊天)。

常见问题解答

  • 错误代码
  • 200:请求成功。
  • 400:请求参数缺失或无效。
  • 500:服务器内部错误(如API问题)。

使用教程

使用依赖

  • Python 3.7或更高版本
  • Google AI API密钥

安装教程

  1. 克隆仓库:
git clone https://github.com/yourusername/mcp-gemini-server.git
cd mcp-gemini-server
  1. 创建虚拟环境:
python -m venv venv
  1. 激活虚拟环境:
  2. Windows: venv\Scripts\activate
  3. macOS/Linux: source venv/bin/activate
  4. 安装依赖:
pip install -r requirements.txt
  1. 创建.env文件并添加API密钥:
GEMINI_API_KEY=your_api_key_here

调试方式

  1. 启动服务器:
python server.py
  1. 服务器默认运行在http://localhost:5000/
  2. 使用test_client.py测试功能:
python test_client.py          # 测试所有功能
python test_client.py text     # 测试文本生成
python test_client.py analyze  # 测试文本分析
python test_client.py chat     # 测试聊天功能

许可证

该项目遵循 MIT 开源许可条款。