Metadata-Version: 2.4
Name: gemini-mcp
Version: 0.2.5
Summary: MCP server for Gemini AI image processing - 基于 Gemini 2.5 Flash 的图片处理 MCP 服务
Project-URL: Homepage, https://github.com/yourusername/gemini-mcp
Project-URL: Documentation, https://github.com/yourusername/gemini-mcp#readme
Project-URL: Repository, https://github.com/yourusername/gemini-mcp
Project-URL: Issues, https://github.com/yourusername/gemini-mcp/issues
Author-email: Your Name <your.email@example.com>
License: MIT
License-File: LICENSE
Keywords: ai,claude,gemini,image-processing,llm,mcp
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.8
Requires-Dist: fastmcp>=0.1.0
Requires-Dist: httpx[socks]>=0.24.0
Requires-Dist: openai>=1.0.0
Requires-Dist: pillow>=10.0.0
Requires-Dist: python-dotenv>=1.0.0
Requires-Dist: socksio>=1.0.0
Provides-Extra: dev
Requires-Dist: black>=23.0.0; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.21.0; extra == 'dev'
Requires-Dist: pytest>=7.0.0; extra == 'dev'
Requires-Dist: ruff>=0.1.0; extra == 'dev'
Description-Content-Type: text/markdown

# Gemini MCP

基于 Gemini 2.5 Flash 的图片处理 MCP 服务器，支持与 Claude Desktop、Cursor 等 MCP 客户端集成。

## 快速开始

### 使用 uvx 运行（推荐）

```bash
# 无需安装，直接运行
GEMINI_API_KEY=your-api-key uvx gemini-mcp
```

### 通过 pip 安装

```bash
pip install gemini-mcp
GEMINI_API_KEY=your-api-key gemini-mcp
```

## 配置客户端

### Claude Desktop

编辑 `~/Library/Application Support/Claude/claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "gemini": {
      "command": "uvx",
      "args": ["gemini-mcp"],
      "env": {
        "GEMINI_API_KEY": "your-api-key"
      }
    }
  }
}
```

### Cursor

编辑 `~/.cursor/mcp.json`:

```json
{
  "mcpServers": {
    "gemini": {
      "command": "uvx",
      "args": ["gemini-mcp"],
      "env": {
        "GEMINI_API_KEY": "your-api-key"
      }
    }
  }
}
```

## 功能

- 🖼️ 支持本地文件、URL 和 Base64 图片
- 🚀 使用 uvx 无需安装即可运行
- 🔄 流式响应处理
- 📦 自动保存生成的图片
- 🌐 支持 SOCKS5 代理

## 使用示例

在 Claude Desktop 中：

```
分析这张图片：/path/to/image.jpg
描述 https://example.com/image.png 的内容
```

## 环境变量

- `GEMINI_API_KEY`: Gemini API 密钥（必需）
- `OUTPUT_DIR`: 输出目录（默认：`./outputs`）
- `ALL_PROXY`: SOCKS5 代理（如：`socks5://127.0.0.1:1080`）

## 命令行参数

```bash
gemini-mcp --help              # 查看帮助
gemini-mcp --mode http         # HTTP 模式
gemini-mcp --debug             # 调试模式
```

## 许可证

MIT