MCP server for Gemini AI image processing - 基于 Gemini 2.5 Flash 的图片处理 MCP 服务
Project description
Gemini MCP
基于 Gemini 2.5 Flash 的图片处理 MCP 服务器,支持与 Claude Desktop、Cursor 等 MCP 客户端集成。
快速开始
使用 uvx 运行(推荐)
# 无需安装,直接运行
GEMINI_API_KEY=your-api-key uvx gemini-mcp
通过 pip 安装
pip install gemini-mcp
GEMINI_API_KEY=your-api-key gemini-mcp
配置客户端
Claude Desktop
编辑 ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"gemini": {
"command": "uvx",
"args": ["gemini-mcp"],
"env": {
"GEMINI_API_KEY": "your-api-key"
}
}
}
}
Cursor
编辑 ~/.cursor/mcp.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)
命令行参数
gemini-mcp --help # 查看帮助
gemini-mcp --mode http # HTTP 模式
gemini-mcp --debug # 调试模式
许可证
MIT
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file gemini_mcp-0.2.6.tar.gz.
File metadata
- Download URL: gemini_mcp-0.2.6.tar.gz
- Upload date:
- Size: 16.0 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
3839491627423299864c5ac7d22a292178f38ce8a14e11c49a10fe8450a2e641
|
|
| MD5 |
72971371c7d1bc24a3e7d5d08367de89
|
|
| BLAKE2b-256 |
83fef4ae99b28c1aa7031fea8bb911a3329b3c4197a9a4f2790397bf5de69a0e
|
Provenance
The following attestation bundles were made for gemini_mcp-0.2.6.tar.gz:
Publisher:
publish.yml on Ceeon/gemini-mcp
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
gemini_mcp-0.2.6.tar.gz -
Subject digest:
3839491627423299864c5ac7d22a292178f38ce8a14e11c49a10fe8450a2e641 - Sigstore transparency entry: 468071398
- Sigstore integration time:
-
Permalink:
Ceeon/gemini-mcp@ab51a4bf9ab49411d7107928e399106bbf2fe3be -
Branch / Tag:
refs/tags/v0.2.6 - Owner: https://github.com/Ceeon
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@ab51a4bf9ab49411d7107928e399106bbf2fe3be -
Trigger Event:
release
-
Statement type:
File details
Details for the file gemini_mcp-0.2.6-py3-none-any.whl.
File metadata
- Download URL: gemini_mcp-0.2.6-py3-none-any.whl
- Upload date:
- Size: 13.7 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
07de83e26aaf0919ea90843dd955ac6191f300eb11a5c98003b8e0619140687e
|
|
| MD5 |
9207cb44bd83205ae2ad2a980a146978
|
|
| BLAKE2b-256 |
890f7ca1b46578571f03ead61ed7e2125630d81b9f52ed0df76f533b1e262893
|
Provenance
The following attestation bundles were made for gemini_mcp-0.2.6-py3-none-any.whl:
Publisher:
publish.yml on Ceeon/gemini-mcp
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
gemini_mcp-0.2.6-py3-none-any.whl -
Subject digest:
07de83e26aaf0919ea90843dd955ac6191f300eb11a5c98003b8e0619140687e - Sigstore transparency entry: 468071422
- Sigstore integration time:
-
Permalink:
Ceeon/gemini-mcp@ab51a4bf9ab49411d7107928e399106bbf2fe3be -
Branch / Tag:
refs/tags/v0.2.6 - Owner: https://github.com/Ceeon
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@ab51a4bf9ab49411d7107928e399106bbf2fe3be -
Trigger Event:
release
-
Statement type: