AI导哈

模型协议服务器

一个将本地Ollama实例作为工具暴露给Claude Code的MCP服务器，用于代码生成、草稿、嵌入和快速问答。

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

使用说明

Ollama-MCP

一个MCP（模型上下文协议）服务器，它公开本地 奥拉玛 实例作为工具 克劳德代码.

让Claude将代码生成、草稿、嵌入和快速问题卸载到本地GPU。

设置

  1. 运行安装脚本：

    bash setup.sh

    这将创建一个venv，安装依赖关系，生成特定于机器的 config.json，并用克劳德码注册MCP服务器。

    注： setup.sh 用途 cygpath 并以Windows为目标（Git Bash/MSYS2）。在Linux/macOS上，替换 cygpath -w 直接调用路径或手动注册：

    claude mcp add ollama -s user -- /path/to/.venv/bin/python /path/to/src/ollama_mcp/server.py

  2. 重新启动克劳德代码。

工具

工具 说明
ollama_generate 单圈提示→ 回应
ollama_chat 多回合对话
ollama_embed 生成嵌入向量
ollama_list_models 列出Ollama实例上的模型

配置

复制 config.example.json 到 config.json 并填写您的机器详细信息，或 setup.sh 以交互方式生成它。

需求

  • Python 3.10+
  • 奥拉玛 0.4.0+至少在一台机器上运行
  • 支持MCP的Claude代码

发展

pip install -e ".[dev]"
pytest tests/ -v

关于

从私有开发人员基础设施仓库中提取，并作为独立工具发布。该服务器每天作为跨游戏引擎、RAG管道和任务编排的多项目AI开发工作流的一部分运行——请参阅 mcp抹布 和 编排引擎 对于使用它的项目。

故障排除

问题 原因 修复
config.json not found 安装程序未运行 运行 bash setup.sh
404嵌入调用 Ollama<0.4.0 升级Ollama(ollama update)
Cannot connect to... Ollama未在目标主机上运行 启动Ollama： ollama serve 或者检查Docker
Request timed out 大型号/硬件速度慢 增加 timeout 在config.json中，或通过 timeout 参数
OFFLINE 在list_models中 主机无法访问 检查网络、防火墙、Ollama端口11434
cygpath: command not found 在Linux/macOS上运行setup.sh 请参阅上面的安装说明

许可证

麻省理工学院

相关 MCP