MCP Ollama Agent

🚀 TypeScript MCP 代理與 Ollama 集成

本項目展示了 Model Context Protocol (MCP) 服務器與 Ollama 的集成，藉助統一接口，讓 AI 模型能夠與各類工具進行交互。

✨ 主要特性

• 支持多個 MCP 服務器（已對 uvx 和 npx 進行測試）。
• 內置文件系統操作和網絡搜索功能。
• 可通過 mcp-config.json 進行配置，與 claude_desktop_config.json 類似。
• 具備交互式聊天界面，支持與 Ollama 集成並使用任意工具。
• 擁有獨立的演示模式，用於在無需大語言模型（LLM）的情況下測試 Web 和文件系統工具。

🚀 快速開始

先決條件

• Node.js（版本 18 或更高）。
• 已安裝並運行 Ollama。
• 全局安裝所需的 MCP 工具：

# 文件系統操作
npm install -g @modelcontextprotocol/server-filesystem

# 網絡搜索
npm install -g @mzxrai/mcp-webresearch

克隆和安裝

git clone https://github.com/ausboss/mcp-ollama-agent.git
cd mcp-ollama-agent
npm install

在 mcp-config.json 中配置工具和 Ollama 模型

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["@modelcontextprotocol/server-filesystem", "./"]
    },
    "webresearch": {
      "command": "npx",
      "args": ["-y", "@mzxrai/mcp-webresearch"]
    }
  },
  "ollama": {
    "host": "http://localhost:11434",
    "model": "qwen2.5:latest"
  }
}

運行演示模式以測試文件系統和網絡搜索工具（無需 LLM）

npx tsx ./src/demo.ts

或啟動帶有 Ollama 的聊天界面

npm start

🔧 技術細節

配置

• MCP 服務器：可將任何 MCP 兼容的服務器添加到 mcpServers 部分。
• Ollama：配置主機和模型（模型必須支持函數調用）。
• 支持 Python (uvx) 和 Node.js (npx) 的 MCP 服務器。

💻 使用示例

基礎用法

使用的模型是 qwen2.5:latest

聊天開始。輸入 "exit" 結束對話。
你：你能使用你的列表目錄工具查看 test-directory 中的內容，然後使用讀取文件工具將其內容發送給我嗎？
模型正在使用工具幫助回答...
使用工具：list_directory
參數：{ path: 'test-directory' }
工具結果：[ { type: 'text', text: '[FILE] test.txt' } ]
助理：
模型正在使用工具幫助回答...
使用工具：read_file
參數：{ path: 'test-directory/test.txt' }
工具結果：[ { type: 'text', text: 'rosebud' } ]
助理：`test-directory` 中 `test.txt` 文件的內容是：
rosebud
你：謝謝
助理：不客氣！如果你有其他需求或需要進一步幫助，請隨時告訴我。

🤝 貢獻

歡迎貢獻代碼！你可以隨意提交問題或拉取請求。