基本能力
产品定位
ollama-mcp-bridge 是一个桥梁服务,旨在将本地大型语言模型与 MCP 服务器连接起来,提供类似于 Claude 的功能,包括文件操作、网络搜索、GitHub 交互、Google Drive 和 Gmail 集成、内存/存储以及图像生成等。
核心功能
- 多 MCP 支持:动态工具路由,支持多种 MCP 服务器。
- 结构化输出验证:对工具调用进行验证,确保输出格式正确。
- 自动工具检测:根据用户提示自动检测并调用合适的工具。
- 强大的进程管理:管理 Ollama 进程,确保稳定运行。
- 详细的日志记录和错误处理:提供详细的日志和错误处理机制。
适用场景
- 文件系统操作:创建、删除、移动文件或文件夹。
- 网络搜索:通过 Brave Search 进行网络搜索。
- GitHub 交互:与 GitHub 进行交互,如提交代码、查看仓库等。
- Google Drive 和 Gmail 集成:管理 Google Drive 文件或发送电子邮件。
- 图像生成:使用 Flux 生成图像。
- 内存/存储:提供持久化存储功能。
工具列表
- Filesystem operations (
@modelcontextprotocol/server-filesystem
):文件系统操作。 - Brave Search (
@modelcontextprotocol/server-brave-search
):网络搜索。 - GitHub (
@modelcontextprotocol/server-github
):GitHub 交互。 - Memory (
@modelcontextprotocol/server-memory
):内存/存储。 - Flux image generation (
@patruff/server-flux
):图像生成。 - Gmail & Drive (
@patruff/server-gmail-drive
):Gmail 和 Google Drive 集成。
常见问题解答
- 如何配置 MCP 服务器:通过
bridge_config.json
文件配置 MCP 服务器和 LLM 设置。 - 如何获取 API 密钥:需要设置
BRAVE_API_KEY
、GITHUB_PERSONAL_ACCESS_TOKEN
和REPLICATE_API_TOKEN
等环境变量。 - 如何授权 Gmail/Drive MCP:运行
node path/to/gmail-drive/index.js auth
进行授权。
使用教程
使用依赖
-
安装 Ollama 并拉取所需模型:
bash
ollama pull qwen2.5-coder:7b-instruct -
安装 MCP 服务器:
bash
npm install -g @modelcontextprotocol/server-filesystem
npm install -g @modelcontextprotocol/server-brave-search
npm install -g @modelcontextprotocol/server-github
npm install -g @modelcontextprotocol/server-memory
npm install -g @patruff/server-flux
npm install -g @patruff/server-gmail-drive
安装教程
- 配置环境变量:
- 设置
BRAVE_API_KEY
用于 Brave Search。 - 设置
GITHUB_PERSONAL_ACCESS_TOKEN
用于 GitHub。 -
设置
REPLICATE_API_TOKEN
用于 Flux。 -
授权 Gmail/Drive MCP:
bash
node path/to/gmail-drive/index.js auth -
配置
bridge_config.json
文件,定义 MCP 服务器和 LLM 设置。
调试方式
-
启动桥接器:
bash
npm run start -
可用命令:
list-tools
:显示可用工具。- 常规文本:发送提示给 LLM。
quit
:退出程序。
示例交互:
```
Search the web for "latest TypeScript features"
[使用 Brave Search MCP 查找结果]Create a new folder called "project-docs"
[使用 Filesystem MCP 创建目录]Send an email to user@example.com
[使用 Gmail MCP 发送电子邮件]
```