Gemini命令行工具

Gemini命令行工具是一个基于Model Context Protocol (MCP)的可扩展CLI开发框架,支持交互式对话和自定义工具集成。

  • by bhs121
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 bhs121/ocp-mcp

使用说明

🤖 我的自定义Gemini CLI项目

此存储库作为开发的起点 Gemini命令行界面(CLI) 并使用 模型上下文协议(MCP).

🛠️ 先决条件

  1. Node.js (建议使用v20或更高版本)
  2. npm (节点包管理器)
  3. Gemini API密钥 (设置为环境变量 GEMINI_API_KEY)
  4. 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会话,请执行以下操作:

  1. 启动MCP服务器: 导航到服务器目录并运行它。 (具体命令将取决于服务器的语言/框架。, npm start 或 python server.py).

  2. 在中配置 settings.json: 在CLI的配置中添加一个条目,告诉它在哪里可以找到服务器。使用 /settings CLI中的命令来编辑此文件。

    {
      "mcpServers": {
        "custom-tool": {
          "command": "npm", // or 'python', etc.
          "args": ["start"],
          "cwd": "./mcp-server" // Path to your server's directory
        }
      }
    }
    
  3. 重新启动/使用CLI: Gemini现在应该可以使用自定义MCP服务器中的新工具了。您可以通过以下方式进行验证 /mcp 或 /tools 命令。

✍️ 定制和进一步开发

您可以通过以下方式自定义此项目:

  • 编辑 GEMINI.md: 使用此文件为特定项目的Gemini模型提供高级说明、样式指南和上下文。
  • 开发MCP服务器: 在中扩展服务器 ./mcp-server 通过添加更多工具与外部API、数据库或内部系统集成。
  • 创建扩展: 探索Gemini CLI文档,以构建更高级集成的扩展。