JinDaGe - ollama-mcp MCP Details

article

README

🚀 Ollama MCP 服务器

Ollama MCP 服务器是专为 Ollama 打造的 MCP（模型上下文协议）服务器，它能让 Ollama 的本地大语言模型（LLM）与支持 MCP 的应用程序（如 Claude Desktop）实现无缝集成，为用户提供更便捷的使用体验。

✨ 主要特性

可列出所有可用的 Ollama 模型，方便用户快速了解模型资源。
支持拉取新的 Ollama 模型，及时获取最新模型。
借助 Ollama 的聊天 API 与模型进行对话，实现交互功能。
能够获取详细的模型信息，帮助用户深入了解模型特性。
具备自动端口管理功能，简化端口配置流程。
支持通过环境变量进行灵活配置。

📦 安装指南

手动安装

可通过 npm 进行全局安装，执行以下命令：

npm install -g @rawveg/ollama-mcp

在其他 MCP 应用程序中安装

若要在其他 MCP 兼容的应用程序（如 Cline 或 Claude Desktop）中安装 Ollama MCP 服务器，需在应用程序的 MCP 设置文件中添加如下配置：

{
  "mcpServers": {
    "@rawveg/ollama-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@rawveg/ollama-mcp"
      ]
    }
  }
}

不同应用程序的设置文件位置有所不同：

Claude Desktop：Claude 应用数据目录中的 claude_desktop_config.json。
Cline：VS Code 全局存储中的 cline_mcp_settings.json。

💻 使用示例

启动服务器

基础用法

简单运行以下命令即可启动服务器：

ollama-mcp

服务器默认会在端口 3456 上启动。

高级用法

您可以通过环境变量指定不同的端口，示例如下：

PORT=3457 ollama-mcp

环境变量

PORT：用于指定服务器端口，默认值为 3456。可在直接运行时使用，示例如下：
```
# 直接运行时
PORT=3457 ollama-mcp
```
OLLAMA_API：用于指定 Ollama API 端点，默认值为 http://localhost:11434。

API 端点

GET /models：列出所有可用模型。
POST /models/pull：拉取新的模型。
POST /chat：与模型进行对话。
GET /models/:name：获取指定模型的详细信息。

📚 详细文档

开发步骤

克隆项目仓库：

git clone https://github.com/rawveg/ollama-mcp.git
cd ollama-mcp

安装项目所需的依赖项：

npm install

构建项目：

npm run build

启动服务器：

npm start

贡献说明

欢迎大家为项目做出贡献！您可以随时提交 Pull Request。

不过，未经事先讨论并达成协议，您不被允许将此项目整合到第三方服务或商业平台中。此前，为支持与 Smithery 的集成，我接受过相关贡献（如 Dockerfile 和 README 更新）。但近期 Glama 的行为让我重新评估了这一政策。

Glama 在未事先通知或征得同意的情况下，将开源 MCP 项目纳入其商业产品，随后还创建问题请求，要求维护者无偿进行工作以确保与其平台兼容。这种利用社区劳动力谋取利益却不给予报酬的行为，不仅不礼貌，而且 从伦理上讲是不可接受的。

为保护贡献者的权益和项目的可持续性，我决定将此项目的许可证从 MIT 转换为 AGPL - 3.0 或更高版本。这一转变可确保所有依赖该项目构建商业产品或服务的公司对社区保持透明，并分享其利润。

贡献指南

若您希望为该项目贡献力量，请参考以下步骤：

提交问题：当遇到问题或有疑问时，可在 GitHub 仓库中提出 issue。
修复错误：找到您感兴趣的错误或功能缺失问题，通过提交 Pull Request 来解决。
添加功能：若有新功能的想法，建议先通过 issue 或 PR 进行讨论，确保其符合项目整体方向。
改进文档：文档是项目的重要组成部分，欢迎提出任何改进建议。

📄 许可证

此项目受 AGPL - 3.0 许可证保护。

ollama-mcp