内容
# Gemini MCP Server
一个模型上下文协议(Model Context Protocol,MCP)服务器,提供 Google Gemini AI 功能作为工具。使用 Deno 和 TypeScript 构建。
## 特性
- **ask_gemini**: 由 Gemini 3 Pro 提供支持的统一 AI 助手,内置 Google 搜索和 URL 分析功能
## 先决条件
- [Deno](https://deno.land/) (v1.40+)
- Google Gemini API 密钥 ([在这里获取](https://ai.google.dev/))
## 安装
### 选项 1:使用 JSR 包(推荐)
最简单的方法是直接在您的 Claude Desktop 配置中使用发布的 JSR 包:
```bash
```
# 无需安装!直接在你的 Claude 配置中使用 jsr:@cong/gemini-mcp
```
### 选项 2:从源代码
1. 克隆这个仓库:
```bash
git clone <repository-url>
cd gemini-mcp
```
2. 设置你的环境变量:
```bash
export GEMINI_API_KEY=your_api_key_here
export GEMINI_MODEL=gemini-3-pro-preview
```
## 使用方法
### 启动服务器
```bash
```
# 首先设置你的环境变量
export GEMINI_API_KEY=your_api_key_here
export GEMINI_MODEL=gemini-3-pro-preview
# 开发模式(带监视)
deno task dev
# 生产模式
deno task start
```
### 使用 MCP Inspector 进行测试
要使用 MCP Inspector 测试服务器,请确保您的环境变量已设置:
```bash
```
# 在你的 shell 中设置环境变量
export GEMINI_API_KEY=your_api_key_here
export GEMINI_MODEL=gemini-3-pro-preview
# 如果尚未安装,请安装 MCP Inspector
npm install -g @modelcontextprotocol/inspector
# 运行检查器
npx @modelcontextprotocol/inspector src/server.ts
```
**重要**:环境变量必须在运行 MCP Inspector 的同一个 shell 中设置。
### 运行测试
```bash
```
# 运行所有测试
deno task test
# 以观察模式运行测试
deno task test:watch
```
### 代码质量
```bash
```
# 格式化代码
deno fmt
# 检查代码
deno lint
```
## MCP 工具
### ask_gemini
由 Gemini 3 Pro 驱动的统一 AI 助手,具备内置的 Google 搜索和 URL 分析功能。
**参数:**
- `prompt`(必填):您的问题或请求。请直接在文本中包含要分析的 URL。
**示例:**
```json
{
"name": "ask_gemini",
"arguments": {
"prompt": "What are the latest developments in quantum computing? Please analyze this paper: https://arxiv.org/abs/2301.01234"
}
}
```
**功能:**
- 🔍 自动搜索网络以获取当前信息
- 📄 分析您提示文本中提到的 URL
- 🧠 使用具备思考能力的 Gemini 3 Pro,urlContext 和 googleSearch 工具
- 📚 提供全面、来源可靠的答案,并增强推理能力
## 依赖项
- [@modelcontextprotocol/sdk](https://github.com/modelcontextprotocol/typescript-sdk) - MCP TypeScript SDK
- [@google/generative-ai](https://github.com/google/generative-ai-js) - Google Gemini API 客户端
- [zod](https://github.com/colinhacks/zod) - 运行时类型验证
- [@std/assert](https://jsr.io/@std/assert) - Deno 标准库断言
## 开发
该项目使用 Deno 和 TypeScript。主要开发命令:
- `deno task dev` - 启动带有监视模式的开发服务器
- `deno task test` - 运行测试套件
- `deno cache src/server.ts` - 缓存依赖
- `deno fmt` - 格式化代码
- `deno lint` - 代码检查
## 故障排除
### 环境变量问题
如果您遇到环境变量错误:
1. **验证您的环境变量是否已设置**:
```bash
echo $GEMINI_API_KEY
echo $GEMINI_MODEL
```
2. **对于MCP Inspector测试**,确保这两个变量在同一个终端中设置:
```bash
export GEMINI_API_KEY=your_api_key_here
export GEMINI_MODEL=gemini-3-pro-preview
npx @modelcontextprotocol/inspector src/server.ts
```
3. **检查服务器日志**:当服务器启动时,它会显示
`(API Key: configured)` 以确认您的密钥已加载。
## 支持
- [Google Gemini API 文档](https://ai.google.dev/gemini-api/docs)
- [模型上下文协议 (Model Context Protocol)](https://modelcontextprotocol.io/)
- [Deno 文档](https://docs.deno.com/)
## Claude桌面配置
要将此MCP服务器与Claude桌面一起使用,请将其添加到您的Claude配置中:
### macOS/Linux/Windows
编辑您的 Claude 配置文件:
- **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
- **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
```json
{
"mcpServers": {
"gemini": {
"command": "deno",
"args": [
"run",
"--allow-net",
"--allow-env",
"jsr:@cong/gemini-mcp"
],
"env": {
"GEMINI_API_KEY": "your_api_key_here",
"GEMINI_MODEL": "gemini-3-pro-preview"
}
}
}
}
```
### 本地开发
如果你是从源代码运行:
```json
{
"mcpServers": {
"gemini": {
"command": "deno",
"args": [
"run",
"--allow-net",
"--allow-env",
"src/server.ts"
],
"env": {
"GEMINI_API_KEY": "your_api_key_here",
"GEMINI_MODEL": "gemini-3-pro-preview"
}
}
}
}
```
## 贡献
1. Fork 该仓库
2. 创建一个功能分支
3. 进行更改
4. 运行测试:`deno task test`
5. 格式化代码:`deno fmt`
6. 提交一个拉取请求
## 许可证
MIT 许可证 - 详见 [LICENSE](LICENSE) 文件。