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
你：谢谢
助理：不客气！如果你有其他需求或需要进一步帮助，请随时告诉我。

🤝 贡献

欢迎贡献代码！你可以随意提交问题或拉取请求。