TypeScript MCP 代理与 Ollama 集成

该项目展示了 Model Context Protocol (MCP) 服务器与 Ollama 之间的集成，允许 AI 模型通过统一接口交互各种工具。

✨ 功能特性

• 支持多个 MCP 服务器（已测试 uvx 和 npx）
• 内置文件系统操作和网络搜索功能
• 通过 mcp-config.json 配置，类似于 claude_desktop_config.json
• 具有交互式聊天界面，支持与 Ollama 集成并使用任何工具
• 独立的演示模式，用于测试无需 LLM 的 Web 和文件系统工具

🚀 快速上手指南

1. 先决条件：

   • Node.js（版本 18 或更高）

   • 已安装并运行 Ollama

   • 安装所需的 MCP 工具（全局）：

     # 文件系统操作
     npm install -g @modelcontextprotocol/server-filesystem
     
     # 网络搜索
     npm install -g @mzxrai/mcp-webresearch
     

2. 克隆和安装：

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

3. 在 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"
     }
   }
   

4. 运行演示模式以测试文件系统和网络搜索工具，无需 LLM：

   npx tsx ./src/demo.ts
   

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

🤝 贡献

欢迎贡献！随意提交问题或拉取请求。