MCP-Gemini

用于 Google Gemini Pro 的提示词管理系统。

当前状态

已实现

• ✅ 项目基本结构
• ✅ Docker 和 Docker Compose 配置
• ✅ 标准化日志系统
• ✅ 带有安全过滤器的指标系统
• ✅ 单元测试：
  • ✅ GeminiClient
  • ✅ FileSystemService
  • ✅ SearchService
  • ✅ CacheService
  • ✅ 日志系统
  • ✅ 指标系统
• ✅ 主要服务：
  • ✅ 缓存系统
  • ✅ 搜索系统
  • ✅ 文件系统
  • ✅ 日志系统
  • ✅ 安全过滤系统
  • ✅ 指标系统

进行中

• 🔄 与 Gemini API 集成
• 🔄 提示词管理系统
• 🔄 用户界面

待完成

• ⏳ 身份验证系统
• ⏳ 实时监控系统
• ⏳ 完整文档
• ⏳ 集成测试
• ⏳ 性能测试
• ⏳ 生产环境部署

要求

• Python 3.10+
• Docker 和 Docker Compose
• Google Gemini API 密钥

安装

1. 克隆仓库：

git clone https://github.com/tu-usuario/mcp-gemini.git
cd mcp-gemini

2. 配置环境变量：

cp .env.example .env
# 编辑 .env 文件，填入你的凭据

3. 安装依赖：

pip install -r requirements.txt

4. 使用 Docker 运行：

docker-compose up -d

项目结构

mcp-gemini/
├── app/
│   ├── api/
│   ├── core/
│   │   ├── config/
│   │   ├── logging/
│   │   └── security/
│   ├── models/
│   ├── services/
│   └── utils/
├── data/
│   ├── prompts/
│   ├── cache/
│   └── metrics/
├── docs/
├── logs/
│   ├── app/
│   ├── access/
│   ├── error/
│   └── safety/
├── tests/
│   ├── unit/
│   ├── integration/
│   └── e2e/
├── .env.example
├── docker-compose.yml
├── Dockerfile
└── requirements.txt

使用

from app.services.gemini_client import GeminiClient

client = GeminiClient(api_key="tu-api-key")
response = client.generate("Tu prompt aquí")
print(response)

测试

# 运行所有测试
pytest

# 运行单元测试
pytest tests/unit

# 运行集成测试
pytest tests/integration

# 运行 e2e 测试
pytest tests/e2e

贡献

1. Fork 仓库
2. 创建你的 feature 分支 (git checkout -b feature/amazing-feature)
3. 提交你的更改 (git commit -m 'Add some amazing feature')
4. 推送到分支 (git push origin feature/amazing-feature)
5. 提交 Pull Request

许可证

本项目基于 MIT 许可证 - 详见 LICENSE 文件。

已实现功能

• 带有文件轮换的日志系统
• 指标和监控系统
• 用于有害内容的安全过滤器
• 请求的异步处理
• 主要服务的单元测试

开发中

• 与 Gemini API 集成
• 提示词管理系统
• 用户界面

待办事项

• 实时监控系统
• 身份验证和授权系统
• 性能测试和优化
• API 文档

项目结构

mcp-gemini/
├── app/
│   ├── api/            # API 端点
│   ├── core/           # 核心功能
│   │   ├── logging/    # 日志系统
│   │   └── config/     # 配置
│   ├── services/       # 应用程序服务
│   │   ├── metrics.py  # 指标服务
│   │   └── async_processor.py  # 异步处理
│   └── utils/          # 实用工具
├── data/
│   ├── metrics/        # 指标数据
│   └── cache/          # 响应缓存
├── logs/               # 日志文件
│   ├── app/           
│   ├── access/
│   └── error/
├── tests/              # 测试
│   ├── unit/
│   └── integration/
├── requirements.txt    # 依赖
└── README.md