MCP 文件服务器连接器

1.项目信息

• 项目标题： 构建您自己的MCP文件服务器连接器
• 课程与部分： BSCS-3A
• 文档参考： CS3-WK06-MCP - 期中考试第1部分
• 编程语言： Python 3.11
• 协议： 模型上下文协议（MCP）

2.项目简介

MCP 文件服务器连接器是一个基于 Python 的应用程序，允许 AI 客户端通过模型上下文协议（MCP）管理文件。

该系统提供创建、读取、写入、编辑、移动、搜索和删除文件的工具。它还支持目录管理、文件信息、基本 Git 操作和项目检查点。

为了保护文件，服务器将文件操作限制在指定的工作区[T0]]。它还支持通过STDIO的本地连接，以及通过通过HTTPS通过ngrok和基本认证的可流式HTTP进行远程连接。

3.项目目标

该项目旨在：

1. 开发一个MCP服务器，允许AI客户端执行文件管理操作。
2. 限制文件访问已批准的工作区。
3. 验证工具输入以减少无效请求。

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.