🤖 我的自定义Gemini CLI项目
此存储库作为开发的起点 Gemini命令行界面(CLI) 并使用 模型上下文协议(MCP).
🛠️ 先决条件
- Node.js (建议使用v20或更高版本)
- npm (节点包管理器)
- Gemini API密钥 (设置为环境变量
GEMINI_API_KEY) - Gemini CLI (通过npm全局安装):
npm install -g @google/gemini-cli🚀 Gemini CLI使用情况
Gemini CLI可用于交互模式或单次提示。
| 命令 | 描述 | 示例 | ||
|---|---|---|---|---|
gemini | 交互模式 (回复)。开始对话会话。 | gemini | ||
gemini -p | 非交互模式。获取单个响应。 | gemini -p "Write a hello world script in Python." | ||
gemini -v | 检查版本。显示已安装的CLI版本。 | gemini -v | ||
| `echo "..." \ | gemini` | 管道内容。将管道内容作为提示发送。 | `echo "Explain this file: @./src/main.js" \ | gemini` |
✨ 有用的Slash命令(在交互模式下)
/help:显示所有可用的命令和快捷方式。/tools:列出可用的内置工具和MCP工具。/mcp:列出已配置的MCP服务器及其可用工具。/init:生成开始GEMINI.md项目的上下文文件。/settings:打开你的settings.json文件进行自定义。
⚙️ 集成示例MCP服务器
此存储库中包含一个示例MCP服务器 ./mcp-server 目录(您将添加)。要将其连接到Gemini CLI会话,请执行以下操作:
- 启动MCP服务器: 导航到服务器目录并运行它。 *(具体命令将取决于服务器的语言/框架。,
npm start或python server.py)*.
- 在中配置
settings.json: 在CLI的配置中添加一个条目,告诉它在哪里可以找到服务器。使用/settingsCLI中的命令来编辑此文件。
{
"mcpServers": {
"custom-tool": {
"command": "npm", // or 'python', etc.
"args": ["start"],
"cwd": "./mcp-server" // Path to your server's directory
}
}
}- 重新启动/使用CLI: Gemini现在应该可以使用自定义MCP服务器中的新工具了。您可以通过以下方式进行验证
/mcp或/tools命令。
✍️ 定制和进一步开发
您可以通过以下方式自定义此项目:
- 编辑
GEMINI.md: 使用此文件为特定项目的Gemini模型提供高级说明、样式指南和上下文。 - 开发MCP服务器: 在中扩展服务器
./mcp-server通过添加更多工具与外部API、数据库或内部系统集成。 - 创建扩展: 探索Gemini CLI文档,以构建更高级集成的扩展。
