Ollama MCP

🚀 Ollama MCP 服務器

Ollama MCP 服務器是專為 Ollama 打造的 MCP（模型上下文協議）服務器，它能讓 Ollama 的本地大語言模型（LLM）與支持 MCP 的應用程序（如 Claude Desktop）實現無縫集成，極大提升了模型的使用便捷性。

🚀 快速開始

在使用 Ollama MCP 服務器之前，你需要確保滿足以下先決條件：

• Node.js（v16 或更高版本）
• npm
• 已安裝並正在運行的 Ollama

✨ 主要特性

• 模型管理：可列出可用的 Ollama 模型，還能拉取新的 Ollama 模型。
• 模型交互：藉助 Ollama 的聊天 API 與模型進行對話，同時可獲取詳細的模型信息。
• 便捷配置：支持自動端口管理，可通過環境變量進行靈活配置。

📦 安裝指南

手動安裝

你可以通過 npm 全局安裝 Ollama MCP 服務器，命令如下：

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 - 獲取模型詳細信息

🔧 技術細節

開發流程

1. 克隆倉庫：

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

2. 安裝依賴項：

npm install

3. 構建項目：

npm run build

4. 啟動服務器：

npm start

🤝 貢獻

歡迎大家為項目貢獻力量！你可以隨意提交 Pull Request。

不過，需要注意的是，未經事先討論並達成協議，你沒有權限將此項目整合到第三方服務或商業平臺中。此前，項目接受過一些貢獻（如 Dockerfile 和相關 README 更新）以支持與 Smithery 的集成，但近期 Glama 的行為促使項目對這一政策進行了重新評估。

Glama 將開源 MCP 項目納入其商業產品中，既未事先通知也未獲得同意，還創建問題請求維護者進行無償工作以確保與 其 平臺兼容。這種利用社區勞動力謀取利益卻不給予報酬的行為，不僅不禮貌，而且 從倫理上講是不可接受的。

為了保護貢獻者的權益和項目的可持續性，項目決定將許可證從 MIT 轉換為 AGPL - 3.0 或更高版本。這一舉措能確保所有依賴該項目構建商業產品或服務的公司對社區保持透明，並分享其利潤。

貢獻指南

如果你希望為這個項目做出貢獻，請參考以下步驟：

1. 提交問題：在遇到問題或有任何疑問時，歡迎在 GitHub 倉庫中提出 issue。
2. 修復錯誤：找到你感興趣的錯誤或功能缺失，並嘗試通過提交 Pull Request 來解決。
3. 添加功能：如果有新功能的想法，請先通過 issue 或 PR 進行討論，以確保它符合項目的整體方向。
4. 改進文檔：文檔是項目的重要組成部分，任何改進建議都非常歡迎。

📄 許可證

此項目受 AGPL - 3.0 許可證保護。