TypeScript MCP with Filesystem Server and Ollama Integration

TypeScript MCP with Filesystem Server and Ollama Integration

一个 TypeScript 示例,展示了 Ollama 与模型上下文协议(MCP)的集成,特别是 Filesystem MCP Server。此项目为能够使用文件系统工具的AI代理提供了一个交互式的命令行界面。

简介

本项目展示了如何使用 TypeScript 集成 模型上下文协议(MCP)Ollama,使 AI 代理能够与本地文件系统交互。

前提条件

  • Node.js (v18+)
  • npm 或 yarn
  • 已安装 Ollama
  • 全局安装的 Filesystem MCP 服务器:
    npm install -g @modelcontextprotocol/server-filesystem
    

快速开始

  1. 克隆并安装依赖

    git clone https://github.com/ausboss/mcp-ollama-agent.git
    cd mcp-ollama-agent
    npm install
    
  2. 配置 mcp-config.json

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

    注意: 确保选择的模型支持工具调用功能

  3. 运行应用

    npm run start
    
  4. 开始交互

    你:test-files 文件夹里有什么?
    助手:[使用 list_directory 工具] `test-files` 文件夹包含 `test.txt` 文件...
    

主要功能

  • 使用 TypeScript SDK 连接 MCP 服务器
  • 文件系统操作(列出目录、读取文件等)
  • 与 Ollama 模型集成
  • 交互式命令行聊天界面

重要说明

  • 谨慎配置文件系统访问路径,避免授予对敏感区域的访问权限
  • 确保使用支持工具调用的 Ollama 模型(如 qwen2.5:latest)

输入 exit 随时退出聊天会话。