🚀 文件系统协议服务器

这是一个基于 Model Context Protocol (MCP) 的文件系统协议服务器，它能让 AI 模型借助上下文协议与文件系统进行交互。该服务器为 AI 模型操作文件系统提供了便捷且安全的途径，极大提升了 AI 模型在文件管理方面的能力。

🚀 快速开始

项目使用 TypeScript 实现，提供了强类型支持。你可以按照以下步骤来运行这个文件系统协议服务器：

1. 使用 npm 进行依赖管理：

npm install

2. 编译源代码：

tsc --build

3. 运行服务器：

node dist/server.js

✨ 主要特性

• 文件操作：可对文件和目录进行读取、写入、更新、删除等操作。
• 目录管理：支持创建、列出、移动、复制目录。
• 状态管理：能够维护会话级状态，例如默认路径。
• 日志记录与错误处理：集成了日志记录和错误处理机制。
• 速率限制：具备防止滥用的保护措施。

📦 安装指南

依赖安装

使用 npm 安装项目依赖：

npm install

代码编译

使用 TypeScript 编译器编译源代码：

tsc --build

💻 使用示例

基础用法

以下是一个读取文件的工具实现示例：

//.ReadFile.ts
export async function read_file(request: ReadFileRequest): Promise<ReadFileResponse> {
    const { path } = request;
    try {
        const content = await fs.promises.readFile(path, 'utf8');
        return { success: true, content };
    } catch (error) {
        return { success: false, error: error.message };
    }
}

📚 详细文档

文件系统结构图

+-filesystem-mcp-server/
| +-dist/                 # 编译后的 JavaScript 输出 (运行 npm run build 后生成)
| +-logs/                # 日志文件（运行时创建）
| +-node_modules/        # 项目依赖项
| +-src/                 # TypeScript 源代码
|   +-config/             # 配置加载（index.ts）
|   +-mcp-server/         # 核心 MCP 服务器逻辑
|   | +-server.ts          # 服务器初始化和工具注册
|   | +-state.ts           # 会话状态管理（例如默认路径）
|   | +-tools/             # 各个工具的实现（每个工具一个子文件夹）
|   | | +-readFile/
|   | | | +-index.ts
|   | | | +-readFileLogic.ts
|   | | | +-registration.ts
|   | | \-...              # 其他工具（writeFile, updateFile 等）
|   +-types-global/       # 共享 TypeScript 类型和接口
|   | +-errors.ts          # 自定义错误类和代码
|   | +-mcp.ts             # MCP 相关类型
|   | \-tool.ts            # 工具定义类型
|   +-utils/              # 可重用的实用工具模块
|   | +-errorHandler.ts
|   | +-idGenerator.ts
|   | +-index.ts
|   | +-logger.ts
|   | +-rateLimiter.ts
|   | +-requestContext.ts
|   | \-sanitization.ts
|   \-index.ts            # 应用程序入口点
| +-clinerules           # Cheatsheet 对于 LLM 代码助手
| +-gitignore
| +-LICENSE
| +-package.json
| +-package-lock.json
| +-README.md             # 本文件
| \-tsconfig.json         # TypeScript 编译器选项

工具列表

基本文件操作工具

目录管理工具

项目结构

核心组件

• Server.ts：作为服务器主程序，负责处理连接和消息路由。
• State.ts：维护会话级状态，包含默认路径等信息。
• Tools/：存放各个文件操作工具的具体实现。

🔧 技术细节

工具实现示例

//.ReadFile.ts
export async function read_file(request: ReadFileRequest): Promise<ReadFileResponse> {
    const { path } = request;
    try {
        const content = await fs.promises.readFile(path, 'utf8');
        return { success: true, content };
    } catch (error) {
        return { success: false, error: error.message };
    }
}

📄 许可证

项目遵循 MIT 许可证，具体条款参见 LICENSE 文件。

👥 构建团队

• 作者：[你的名字]
• 贡献者：[你的名字]
• 维护者：[你的名字]

如需进一步了解 Model Context Protocol，请访问 官方文档。