Ollama MCP (Model Context Protocol)

Ollama MCP（模型上下文协议）

Ollama MCP 是一个工具，用于通过模型上下文协议 (MCP) 将基于 Ollama 的大模型与外部工具和服务连接起来。这个集成使大模型能够与各种系统交互，如 Git 存储库、shell 命令和其他启用工具的服务。

功能

• Ollama 大模型与 MCP 服务之间的无缝集成
• 通过 MCP Git 服务支持 Git 操作
• 可扩展的工具管理系统
• 交互式命令行助手界面
• 启动时从可用的本地模型中进行交互式 Ollama 模型选择

安装

1. 确保安装了 Python 3.13 或更高版本
2. 克隆本仓库
3. 安装依赖项：

# Create a virtual environment
uv add ruff check
# Activate the virtual environment
source .venv/bin/activate
# Install the package in development mode
uv pip install -e .

使用

Ollama 模型选择

在主应用启动前，系统会提示你选择要使用的 Ollama 模型。

1. 前提条件：

   • 确保已安装并运行 Ollama。
   • 本地必须至少拉取了一个模型（例如通过 ollama pull llama3.1:8b）。支持工具使用的模型列表可在 Ollama 网站上找到。

2. 启动过程：

   • 应用程序会自动检测并列出本地计算机上所有可用的 Ollama 模型。
   • 系统会提示你从显示的列表中输入要使用的模型名称。
   • 如果输入无效的模型名称，系统会重新提示，直到做出有效选择。
   • 所选模型随后将被 Agent 用于所有后续操作。

运行 Git 助手

uv run main.py

运行测试

pytest -xvs tests/test_ollama_toolmanager.py

这将启动一个交互式 CLI，你可以在其中要求助手执行 Git 操作。

使用自定义工具进行扩展

你可以通过以下方式扩展系统：

1. 创建新的工具包装器
2. 将其注册到 OllamaToolManager
3. 连接到不同的 MCP 服务

组件

• OllamaToolManager：管理工具注册和执行
• MCPClient：处理与 MCP 服务的通信
• OllamaAgent：协调 Ollama 大模型和工具的使用

示例

# Creating a Git-enabled agent
git_params = StdioServerParameters(
    command="uvx",
    args=["mcp-server-git", "--repository", "/path/to/repo"],
    env=None
)

# Connect and register tools
async with MCPClient(git_params) as client:
    # Register tools with the agent
    # Use the agent for Git operations

要求

• Python 3.13+
• MCP 1.5.0+
• Ollama 0.4.7+