🚀 MCP 双子星协议服务器（MCP Gemini）使用说明

MCP 双子星协议服务器是基于 Node.js 开发的中间件，借助标准 JSON - RPC 协议接口，为用户提供 Gemini AI 服务，涵盖文本生成、图像处理、视频分析和网络搜索等功能。

🚀 快速开始

MCP 双子星协议服务器是用于提供 Gemini AI 服务的中间件。若你想快速体验其功能，可按以下步骤操作：

环境要求

• Node.js 版本 18.0.0 或以上
• npm 或 yarn 包管理工具
• 公共云服务账号（可选）

安装步骤

# 克隆代码仓库
git clone https://github.com/techkwon/mcp-gemini.git

# 进入项目目录
cd mcp-gemini

# 安装依赖包
npm install

# 配置环境变量
export GOOGLE_API_KEY=your_api_key_here

# 启动服务
npm run start

✨ 主要特性

文本生成功能

• 支持多轮对话，让交流更连贯。
• 提供上下文记忆，确保对话逻辑一致。
• 支持多语言，满足不同用户需求。

图像编辑能力

• 基于强大的 Gemini 2.0 模型。
• 支持图像生成与编辑，释放创意。
• 提供多种视觉效果，让图像更出彩。

视频分析功能

• 可解析 YouTube 网络视频。
• 能自动提取内容摘要，节省时间。
• 精准识别定位关键帧。

网络搜索

• 实时检索网络信息。
• 智能筛选结果，提供精准信息。
• 支持多语言搜索，覆盖全球信息。

📦 安装指南

环境要求

• Node.js 版本 18.0.0 或以上
• npm 或 yarn 包管理工具
• 公共云服务账号（可选）

安装步骤

# 克隆代码仓库
git clone https://github.com/techkwon/mcp-gemini.git

# 进入项目目录
cd mcp-gemini

# 安装依赖包
npm install

# 配置环境变量
export GOOGLE_API_KEY=your_api_key_here

# 启动服务
npm run start

功能配置

API 接口设置

• 默认监听地址：localhost
• 监听端口：8000
• CORS 白名单：可配置，支持多个域名

日志管理

• 使用 pino 实现结构化日志记录。
• 开发环境支持 pino - pretty 模块，提供更友好的日志展示。

📚 详细文档

版本记录

v1.0.0 (2024 - 03 - 15)

• 初始版本发布。
• 提供基础功能：文本生成、图像处理、视频分析。

v2.0.0 (2024 - 05 - 20)

• 引入 Gemini 2.0 模型。
• 新增 Web 搜索能力。
• 优化 API 接口。

使用条款

• 仅限于非商业用途，未经允许不得用于盈利目的。
• 修改后的版本必须标注修改声明。
• 原文链接必须保持可见。

安全注意事项

1. API 密钥必须通过环境变量方式传递。
2. 生产环境下建议启用 HTTPS。
3. 禁止在代码中直接嵌入密钥信息。
4. 建议设置访问速率限制。
5. 定期更新安全证书。

故障排除

端口冲突问题

如果出现 8000 端口被占用的情况：

# 查找并终止相关进程
sudo lsof -i :8000

# 或者使用 pstree 命令查看具体进程
pstree -p | grep node

服务稳定性维护

• 建议使用 PM2 等专业工具进行进程管理。
• 定期检查系统日志，分析服务器运行状态。
• 及时处理内存泄漏和性能退化问题。

开发指南

日志系统

• 使用 pino 进行结构化日志记录。
• 支持多种日志输出格式，默认为 JSON 格式。

配置管理

• 环境变量优先级高于配置文件。
• 提供默认配置模板，可根据需求自定义。

项目维护者

• 张三（负责人）
• 李四（技术顾问）

贡献指南

欢迎社区贡献！请先阅读贡献规范文档，了解如何参与代码开发和提交。

📄 许可证

MIT 许可证

版权所有 (c) 2024 星辰科技公司
本项目遵守 MIT 许可证。本项目遵循 MIT 开源协议，所有贡献都将在 MIT 协议下管理。