Advanced Gemini MCP

README.md

🇰🇷 高级Gemini MCP服务器v4.0-韩国开源版

“我们希望这能帮助全球开发者社区！”\ “希望对全球开发者社区有所帮助！”

______________________________________________________________________

📋 目录|목차

• 英语

- 概述 - 特性 - 安装 - 用法 - 配置 - 例子 - api参考 - 贡献 - 许可证

• 韩语

- 概述 - 主要功能 - 安装方法 - 使用方法 - 设置 - 使用示例 - API参考 - 贡献 - 许可证

______________________________________________________________________

英语

概述

这 高级Gemini MCP服务器v4.0 是一个全面的模型上下文协议（MCP）服务器实现，可与谷歌的Gemini AI无缝集成。这个开源项目是由❤️ 在韩国为全球开发者社区做出贡献。

👨‍💻 作者

• 铲球圣塔（Sapjil Santa） -首席开发人员
• 李哈妮（Lee Haneui） -人工智能助理和联合开发人员
• 联系: codenmsanta@gmail.com

特性

🚀 10种先进的人工智能功能

1. 文本生成 -具有可自定义参数的基本文本生成
2. 多模态处理 -支持图像、视频和音频文件
3. 令牌计数 -精确的代币计数用于成本估算
4. 流媒体响应 -长时间响应的实时流媒体
5. 结构化JSON输出 -模式强制JSON生成
6. 系统说明 -带有系统提示的自定义AI行为
7. 函数调用 -动态函数执行能力
8. 代码执行 -使用AI安全执行Python代码
9. 文件上传与分析 -上传和分析各种文件格式
10. 地面搜索 -实时网络搜索集成

🔧 技术特性

• 生产就绪：全面的错误处理和记录
• 安全第一：环境变量API密钥管理
• 韩语+英语：双语文件和错误信息
• MCP兼容：完全符合模型上下文协议
• 异步支持：基于异步的现代架构
• 类型安全：完整的类型提示，以获得更好的开发体验

安装

先决条件

• Python 3.8或更高版本
• Google Gemini API密钥
• pip包管理器

快速安装

# Clone the repository
git clone https://github.com/SapjilSanta/advanced-gemini-mcp.git
cd advanced-gemini-mcp

# Install dependencies
pip install -r requirements.txt

# Set up environment variables
export GEMINI_API_KEY="your-gemini-api-key-here"

包的依赖

google-genai>=0.7.0
mcp>=1.0.0
asyncio
aiofiles
typing-extensions

用法

基本设置

1. 设置API密钥:

   export GEMINI_API_KEY="your-api-key"

1. 运行服务器:

   python advanced_gemini_mcp.py

1. 连接您的MCP客户端 并开始使用10个可用工具！

MCP客户端配置

添加到MCP客户端配置中：

{
  "mcpServers": {
    "advanced-gemini": {
      "command": "python",
      "args": ["/path/to/advanced_gemini_mcp.py"],
      "env": {
        "GEMINI_API_KEY": "your-api-key"
      }
    }
  }
}

配置

环境变量

定制

服务器通过工具参数支持各种配置选项：

• 温度：控制创造力（0.0-1.0）
• 最大令牌数：限制响应长度
• 模型选择：选择特定的Gemini型号
• 文件类型：支持多种媒体格式

例子

文本生成

# Tool: gemini_generate
{
  "prompt": "Explain quantum computing in simple terms",
  "temperature": 0.7,
  "max_tokens": 1000
}

图像分析

# Tool: gemini_multimodal
{
  "prompt": "Describe what you see in this image",
  "image_path": "/path/to/image.jpg"
}

代码执行

# Tool: gemini_code_execution
{
  "prompt": "Calculate the fibonacci sequence up to 10 numbers and plot it"
}

api参考

有关API的详细文档，请参阅 API_REFERENCE.md.

贡献

我们欢迎全球开发者的贡献！ 🌍

开发设置

1. 分叉存储库
2. 创建要素分支
3. 进行更改
4. 添加测试
5. 提交拉取请求

编码标准

• 遵循PEP 8风格指南
• 为所有函数添加类型提示
• 包含公共API的文档字符串
• 编写全面的错误处理

许可证

此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。

______________________________________________________________________

韩语

概述

高级Jamina MCP服务器v4.0是一个全面的模型上下文协议（MCP）服务器实现，可与谷歌的Zemina AI无缝集成。该开源项目是在韩国开发的，旨在为全球开发者社区做出贡献。

👨‍💻 制作者

• 铲球散打 -主要开发者
• 李哈妮 -AI助手&联合开发者
• 联系方式: codenmsanta@gmail.com

主要功能

🚀 10种高级AI功能

1. 生成文本 -生成可自定义的默认文本
2. 多模式处理 -支持图像、视频和音频文件
3. 令牌计算 -准确计算代币以估算成本
4. 流响应 -用于长响应的实时流媒体
5. 结构化的JSON输出 -强制生成模式JSON
6. 系统说明 -通过系统提示自定义AI行为
7. 函数调用 -动态函数执行功能
8. 执行代码 -与AI一起运行安全的python代码
9. 上载和分析文件 -上载和分析各种文件格式
10. 基于依据的搜索 -集成实时Web搜索

🔧 技术特性

• 生产准备：全面的错误处理和记录
• 安全优先：管理环境变量API密钥
• 韩语+英语：双语文档和错误消息
• MCP兼容：完全符合模型上下文协议
• 异步支持：最新的基于asyncio的体系结构
• 类型安全性：更好的开发体验的完整类型提示

安装方法

必备条件

• Python 3.8或更高版本
• Google Gemini API키
• pip包管理器

快速安装

# 저장소 복제
git clone https://github.com/SapjilSanta/advanced-gemini-mcp.git
cd advanced-gemini-mcp

# 의존성 설치
pip install -r requirements.txt

# 환경 변수 설정
export GEMINI_API_KEY="your-gemini-api-key-here"

包依赖性

google-genai>=0.7.0
mcp>=1.0.0
asyncio
aiofiles
typing-extensions

使用方法

首选项

1. API密钥设置:

   export GEMINI_API_KEY="your-api-key"

1. 运行服务器:

   python advanced_gemini_mcp.py

1. MCP客户端连接 后10个工具开始使用！

MCP客户端设置

添加到MCP客户端设置：

{
  "mcpServers": {
    "advanced-gemini": {
      "command": "python",
      "args": ["/path/to/advanced_gemini_mcp.py"],
      "env": {
        "GEMINI_API_KEY": "your-api-key"
      }
    }
  }
}

设置

环境变量

自定义

服务器通过工具参数支持多种设置选项：

• 温度：创意控制（0.0-1.0）
• 最大令牌数：响应长度限制
• 模型选择：选择特定Gemini型号
• 文件类型：支持多种媒体格式

使用示例

生成文本

# 도구: gemini_generate
{
  "prompt": "양자 컴퓨팅을 쉬운 말로 설명해주세요",
  "temperature": 0.7,
  "max_tokens": 1000
}

图像分析

# 도구: gemini_multimodal
{
  "prompt": "이 이미지에서 보이는 것을 설명해주세요",
  "image_path": "/path/to/image.jpg"
}

执行代码

# 도구: gemini_code_execution
{
  "prompt": "피보나치 수열을 10개까지 계산하고 그래프로 그려주세요"
}

API参考

详细的API文档包括： API_REFERENCE.md请参阅。

贡献

欢迎全球开发者的贡献！ 🌍

设置开发环境

1. 存储库叉
2. 创建功能分支
3. 创建更改
4. 添加测试
5. 提交完整请求

编码标准

• 遵守PEP8风格指南
• 向所有函数添加类型提示
• 包含对公共API的独占
• 创建全面的错误处理

许可证

此项目在MIT许可下-详细信息 许可证 请参考文件。

______________________________________________________________________

🌟 明星历史

______________________________________________________________________

💝 支持

如果这个项目对你有帮助，请考虑： 如果这个项目有帮助，请考虑：

• Starring this repository |对此存储库评分
• 🐛 Reporting bugs错误报告
• 💡 Suggesting features功能建议
• 🔀 Contributing code代码贡献
• Buy us a coffee给我买杯咖啡

______________________________________________________________________

🤝 社区

加入我们不断壮大的社区： 加入不断成长的社区：

• GitHub讨论：分享想法并获得帮助
• 问题：报告错误和请求功能
• 电子邮件: codenmsanta@gmail.com直接联系

______________________________________________________________________

Made with❤in South Korea在韩国用爱制作 🇰🇷