让Gemini-CLI使用MCP服务,需要配置MCP服务地址,有两个地方可以配置:
- 如果是想所有的项目都能用 MCP,需要加全局配置文件;
- 如果需要指定项目,则是在指定项目的根目录添加配置文件。
全局的配置文件位于~/.gemini/settings.json
,项目特定的配置文件位于项目根目录下的.gemini/settings.json
。
在需要的目录下,创建这个配置文件:
mkdir -p .gemini && touch .gemini/settings.json
-p
作用是创建父目录。使用-p
参数后,mkdir
会检查路径中的每个目录,如果某个目录不存在,它就会自动创建这些缺失的目录。使用mkdir -p .gemini
则会先创建.gemini
目录(如果它不存在)。touch
命令主要用于创建空文件或更新该文件的访问时间(access time)和修改时间(modification time)到当前时间,但不会改变文件内容。
具体的配置方法在 https://github.com/google-gemini/gemini-cli/blob/main/docs/tools/mcp-server.md 有详细描述。
有三种通讯协议的MCP,均支持,对应的配置中,也是三选一的必填项:
command
(string):Stdio 传输的可执行文件的路径url
(string): SSE 端点 URL (例如,"http://localhost:8080/sse"
)httpUrl
(string):HTTP 流端点 URL
配置完后,需要重启一下 Gemini-CLI
以高德地图的MCP为例
https://lbs.amap.com/api/mcp-server/gettingstarted
配置这里用的基于 HTTP 的 MCP 服务器。
{
...
"mcpServers": {
...
"amap-maps-streamableHTTP": {
"httpUrl": "https://mcp.amap.com/mcp?key=高德地图的key",
"timeout": 5000
}
...
}
}
相关的key获得,请看: https://lbs.amap.com/api/mcp-server/create-project-and-key
重启后,可以看到启用了一个MCP Server
实际的使用效果如下: