MCP File Server Connector

1. Project Information

• Project Title: Build Your Own MCP File Server Connector
• Course and Section: BSCS-3A
• Document Reference: CS3-WK06-MCP - Midterms PT. 1
• Programming Language: Python 3.11
• Protocol: Model Context Protocol (MCP)

2. Project Description

The MCP File Server Connector is a Python-based application that allows AI clients to manage files through the Model Context Protocol (MCP).

The system provides tools for creating, reading, writing, editing, moving, searching, and deleting files. It also supports directory management, file information, basic Git operations, and project checkpoints.

To protect files, the server restricts file operations to the designated workspace, D:\Midterms. It also supports local connections through STDIO and remote connections through Streamable HTTP over HTTPS using ngrok and Basic Authentication.

3. Project Objectives

The project aims to:

1. Develop an MCP server that allows AI clients to perform file-management operations.
2. Restrict file access to an approved workspace.
3. Validate tool inputs to reduce invalid requests.
4. Support local and remote MCP connections.
5. Test the server’s functionality and security.

4. Technologies Used

5. Main Features

• File Management: Create, read, write, edit, move, and delete files.
• Directory Management: Create directories and list their contents.
• File Search: Search for text within files.
• File Information: Retrieve file details, including size information.
• Git Tools: Check repository status and view changes.
• Workspace Security: Reject paths that point outside the approved directory.
• Input Validation: Check selected tool inputs before processing them.
• Local Connection: Connect through STDIO using an MCP-compatible client.
• Remote Connection: Connect through Streamable HTTP using an HTTPS tunnel.
• Project Tracking: Record checkpoints and read project-state information.

6. Available MCP Tools

The server registers 18 tools.