MCP Filesystem

A simple Model Context Protocol (MCP) application that provides filesystem operations using Ollama local LLM. This project demonstrates the integration of local AI models with filesystem operations through a client-server architecture.

Architecture

Related MCP server: filesystem-mcp

Features

• Client-server architecture using MCP protocol

• Integration with Ollama local LLM (Microsoft Phi-3 3.8b model)

• Directory creation capabilities

• Conversational CLI interface

• Secure file system operations within allowed directories

Prerequisites

• Node.js

• Ollama with Phi-3 3.8b model installed

• Basic understanding of terminal operations

Installation

1. Clone the repository

2. Install dependencies:

npm install

Configuration

The server accepts allowed directories as command-line arguments. These directories will be the only locations where the application can perform filesystem operations.

Usage

Start the server:

npm start

The client will automatically start the server and connect to Ollama. You can then interact with the system through natural language commands.

Example commands:

• "Create a directory named 'test'"

• "List the files in the current directory"

• "Delete the file 'test.txt'"

Project Structure

• client.js: MCP client implementation with Ollama integration

• server.js: MCP server implementation with filesystem operations

Dependencies

• @modelcontextprotocol/sdk : Core MCP SDK

• Ollama : Local AI model for natural language processing

• Microsoft Phi-3 3.8b model : AI model for natural language processing