第四章. MCP集成：扩展能力边界

4.1. MCP是什么

一个类比

如果把Gemini CLI比作一个智能手机，那么MCP就是App Store。手机本身有一些内置功能（打电话、发短信），但你可以通过安装App来扩展功能（导航、支付、游戏）。

Gemini CLI内置了一些工具：

• read_file - 读取文件
• write_file - 写入文件
• run_shell_command - 执行命令
• google_web_search - 搜索网页

但总有一些场景是内置工具覆盖不到的：

• 连接数据库查询数据
• 调用公司内部的API
• 访问Figma设计稿
• 读取Notion文档

这时候就需要MCP。社区已经有大量现成的MCP服务器可以直接使用，你只需要简单配置就能让Gemini CLI获得这些能力。

MCP的三种能力

MCP服务器可以提供三种类型的能力：

1. Tools（工具）：AI可以调用的函数，比如query_database、send_email
2. Prompts（提示）：预定义的提示模板，可以作为斜杠命令使用
3. Resources（资源）：AI可以读取的远程资源，比如API文档、配置文件

4.2. 快速配置MCP服务器

配置MCP服务器非常简单，只需要编辑一个配置文件。

步骤1：找到配置文件

打开C:\Users\你的用户名\.gemini\settings.json（如果不存在就创建）。

步骤2：添加MCP服务器配置

在配置文件中添加mcpServers字段：

1
2
3
4
5
6
7
8
9
10
11

{
  "mcpServers": {
    "服务器名称": {
      "command": "命令",
      "args": ["参数1", "参数2"],
      "env": {
        "环境变量名": "环境变量值"
      }
    }
  }
}

步骤3：重启Gemini CLI

保存配置文件后，重新启动Gemini CLI：

1

gemini

步骤4：验证连接

在交互模式中输入/mcp查看MCP服务器状态：

1

> /mcp

如果看到CONNECTED，说明配置成功。

4.3. 常用MCP服务器速查

这里列出几个最常用的MCP服务器配置示例，让你快速上手。

示例1：文件系统访问

1
2
3
4
5
6
7
8

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "D:\\projects"]
    }
  }
}

这个配置让AI可以访问D:\projects目录下的所有文件。

示例2：GitHub集成

1
2
3
4
5
6
7
8
9
10
11

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "你的GitHub Token"
      }
    }
  }
}

这个配置让AI可以访问你的GitHub仓库、创建Issue、提交PR等。

示例3：Google Drive集成

1
2
3
4
5
6
7
8

{
  "mcpServers": {
    "gdrive": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-gdrive"]
    }
  }
}

这个配置让AI可以读取和搜索你的Google Drive文件。

示例4：Brave搜索

1
2
3
4
5
6
7
8
9
10
11

{
  "mcpServers": {
    "brave-search": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-brave-search"],
      "env": {
        "BRAVE_API_KEY": "你的Brave API Key"
      }
    }
  }
}

这个配置让AI可以使用Brave搜索引擎查找最新信息。

4.4. 环境变量的设置

很多MCP服务器需要API Key或Token。在Windows上设置环境变量有两种方式。

方式1：通过系统设置（推荐）

1. 按Win键，搜索"环境变量"
2. 点击"编辑系统环境变量"
3. 点击"环境变量"按钮
4. 在"用户变量"区域，点击"新建"
5. 输入变量名和变量值
6. 点击"确定"保存

方式2：通过PowerShell

1

[System.Environment]::SetEnvironmentVariable('GITHUB_PERSONAL_ACCESS_TOKEN', '你的Token', 'User')

设置后，需要重新打开PowerShell窗口才能生效。

验证环境变量是否设置成功：

1

$env:GITHUB_PERSONAL_ACCESS_TOKEN

如果显示你的Token，说明设置成功。

4.5. 使用MCP工具

配置好MCP服务器后，AI会自动识别可用的工具。

查看可用工具

1

> /mcp

输出：

1
2
3
4
5
6
7

MCP Servers Status:

✓ github (CONNECTED)
  Tools: create_issue, create_pull_request, search_repositories

✓ filesystem (CONNECTED)
  Tools: read_file, write_file, list_directory

让AI使用工具

你不需要手动调用工具，只需要用自然语言描述需求：

1

> 在我的GitHub仓库中创建一个Issue，标题是"修复登录Bug"，内容是"用户无法使用邮箱登录"

AI会自动识别需要使用create_issue工具，并在执行前弹出确认对话框：

1
2
3
4
5
6
7
8
9
10
11
12

MCP Tool Confirmation:
Server: github
Tool: create_issue
Parameters:
  title: "修复登录Bug"
  body: "用户无法使用邮箱登录"

Options:
[1] Allow once
[2] Always allow this tool
[3] Always allow this server
[4] Cancel

选择1允许这次执行，或选择3信任整个服务器。

4.6. MCP Resources：引用远程资源

除了工具，MCP服务器还可以提供Resources（资源）。你可以用@server://语法引用这些资源。

示例：引用GitHub仓库的README

1

> @server://github/my-repo/README.md 总结这个项目的功能

Gemini CLI会自动从GitHub获取README内容，然后让AI进行总结。

示例：引用Google Drive文档

1

> @server://gdrive/项目需求文档 根据这个需求文档生成开发计划

4.7. 命令行管理MCP服务器

除了编辑配置文件，Gemini CLI还提供了命令行工具来管理MCP服务器。

添加服务器

1

gemini mcp add github npx -y @modelcontextprotocol/server-github

列出所有服务器

1

gemini mcp list

输出：

1
2

✓ github: npx -y @modelcontextprotocol/server-github (stdio) - Connected
✓ filesystem: npx -y @modelcontextprotocol/server-filesystem (stdio) - Connected

删除服务器

1

gemini mcp remove github

4.8. 本节小结

我们在本节学习了MCP集成的基础知识。核心要点：

MCP的三种能力：

配置MCP服务器的步骤：

1. 编辑C:\Users\你的用户名\.gemini\settings.json
2. 添加mcpServers配置
3. 设置必要的环境变量
4. 重启Gemini CLI
5. 用/mcp验证连接

速查代码：

1
2
3
4
5
6
7
8
9
10
11
12

// settings.json配置
{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "$GITHUB_TOKEN"
      }
    }
  }
}

1
2
3
4
5
6
7
8
9
10

# 命令行管理
gemini mcp add my-server npx -y @modelcontextprotocol/server-xxx
gemini mcp list
gemini mcp remove my-server

# 交互模式查看
> /mcp

# 使用Resources
> @server://github/my-repo/README.md 总结内容

4.9. 20+实用MCP服务器配置大全

社区已经有大量现成的MCP服务器可以直接使用，涵盖了开发、设计、文档、数据库等各个领域。我整理了20多个最实用的MCP服务器配置，包括：

• 开发工具：GitHub、GitLab、Linear、Sentry
• 设计工具：Figma、Cloudinary
• 文档工具：Notion、Google Drive、Confluence
• 数据库：PostgreSQL、MySQL、SQLite
• 搜索引擎：Brave Search、Exa
• AI服务：Puppeteer、Memory、Fetch
• 其他：Slack、Email、Time、Weather

每个配置都包含：

• 完整的JSON配置代码
• 环境变量设置说明
• 使用示例
• 常见问题解决方案

这些配置不仅适用于Gemini CLI，也适用于Claude Code和Codex CLI，可以直接复制粘贴使用。

👉 点击查看：20+实用MCP服务器配置大全

在那篇文章中，你可以找到所有主流MCP服务器的配置方法，无需从零开发，直接复制配置即可使用。

下一节，我们将学习Hooks系统，了解如何在AI执行的关键节点注入自定义逻辑。