返回 MCP 目录
public公开dns本地运行

gemini-cli

Gemini Rust Suite 是一个基于 Rust 的 Google Gemini 模型交互工具套件,提供 CLI 界面、工具调用协议(MCP)、持久化语义记忆等功能,支持与外部服务集成。

article

README

🚀 如何使用 Gemini Rust 仓库

本项目旨在方便用户使用 Gemini Rust 相关功能,提供了安装、使用、开发等一系列指南,帮助用户快速上手并深入了解该仓库。

🚀 快速开始

你可以按照下面的步骤快速开启使用 Gemini Rust 仓库之旅:

  1. 安装项目,可选择使用脚本安装或手动安装。
  2. 按照使用指南中的示例,尝试基本或高级功能。
  3. 若有开发需求,参考开发指南进行项目开发。

📦 安装指南

使用脚本安装(推荐)

运行以下命令,通过脚本完成安装:

curl -L https://github.com/your-username/gemini-rust_suite/raw/main/install.sh | bash

手动安装步骤

  1. 克隆仓库:
    git clone https://github.com/your-username/gemini-rust_suite.git
    cd gemini-rust_suite
    
  2. 安装依赖项:
    cargo install --all
    
  3. 启动 Gemini CLI:
    cargo run --package gemini-cli -- "你的提示"
    

💻 使用示例

基础用法

  • 发送单个提示:
    gemini "你最喜欢的编程语言是什么?"
    
  • 打开交互式聊天模式:
    gemini -i
    
  • 开始新对话:
    gemini --new-chat "告诉我关于 Rust 的内容。"
    

高级用法

  • 使用任务循环模式:
    gemini -t "优化 src/utils.rs 中的错误处理。"
    
  • 查看配置信息:
    gemini --show-config
    
  • 管理 MCP 守护进程(Zsh 用户):
    mcpd start
    mcpd status
    mcpd stop
    mcpd logs
    

✨ 主要特性

聊天历史记录

  • 聊天记录保存在 ~/.local/share/gemini_suite/history/ 中。
  • 需要使用提供的包装器函数(通过安装脚本添加)才能跨 shell 会话工作。

内存功能

  • 使用 gemini-memory 和 LanceDB 实现。
  • 默认内存文件路径为 ~/.local/share/gemini_suite/memory.db

🔧 技术细节

MCP 集成与函数调用

工具发现

  • Gemini 可以自动发现并使用配置的工具。
  • 当 Gemini 决定使用工具时,会在控制台显示拟执行的操作,并提示确认后再执行。

📚 详细文档

更多内容请参考 官方文档

📚 开发指南

项目结构

克隆仓库并进入项目目录:

git clone https://github.com/your-username/gemini-rust_suite.git
cd gemini-rust_suite

构建项目

运行以下命令构建项目:

cargo build

运行 CLI

启动 CLI 并传入提示信息:

cargo run --package gemini-cli -- "你的提示"

测试

执行测试命令:

cargo test
cargo test --package gemini-core
help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端