智枢MCP文件服务器 (Aegis File MCP Server)

本地运行·插件化交付版本

项目概述

智枢MCP文件服务器是一个连接大模型与复杂文件系统的"智能中枢"，提供安全、高效的文件访问通道，将非结构化文件转化为AI可深度理解的"结构化知识"。

核心特性

• 本地轻量化: 采用单体架构，适配普通PC运行
• 插件化交付: 核心功能封装为插件，可嵌入客户现有系统
• MCP协议兼容: 支持stdio、SSE、HTTP三种通信模式
• 智能文档解析: 多格式文件无损解析，支持增量同步
• AI就绪化处理: 静态/动态因子提取、分层摘要生成
• 本地安全加密: TLS 1.3通信加密、AES-256文件加密

技术栈

• 后端语言: Go 1.22+ (主服务/插件框架), Python 3.11+ (AI/解析任务)
• 数据库: PostgreSQL 16+ (结构化数据), Milvus 2.4+ (向量数据)
• 缓存系统: Redis 7.2+ (本地安装)
• 插件机制: Go plugin + Python setuptools

目录结构

├── cmd/                    # 应用入口点
├── internal/               # 内部包（私有代码）
│   ├── mcp/                # MCP协议适配层
│   ├── core/               # 核心功能层
│   ├── plugin/             # 插件化适配层
│   └── storage/            # 本地存储层
├── pkg/                    # 可公开使用的包
├── scripts/                # 脚本文件
├── configs/                # 配置文件
├── docs/                   # 文档
├── tests/                  # 测试文件
├── go.mod                  # Go模块定义
├── go.sum                  # Go依赖校验
└── README.md               # 项目说明

快速开始

1. 环境准备

Go环境安装（Windows）

我们提供了自动化脚本来安装Go环境，请按照以下步骤操作：

1. 以管理员身份打开PowerShell

   • 在开始菜单搜索"PowerShell"
   • 右键点击"Windows PowerShell"，选择"以管理员身份运行"

2. 执行Go安装脚本

   cd "c:\software\Aegis -File-MCP-Server"
   .\scripts\setup_go.ps1
   

3. 重启终端 安装完成后，请关闭当前PowerShell窗口，重新打开一个新的PowerShell终端。

4. 验证安装

   go version
   # 应该显示: go version go1.22.x windows/amd64
   

其他依赖

确保已安装以下依赖：

• Python 3.11+
• PostgreSQL 16+
• Redis 7.2+

2. 项目初始化

首次克隆项目后，请运行初始化脚本：

# 进入项目目录
cd "c:\software\Aegis -File-MCP-Server"

# 运行初始化脚本
.\scripts\setup.ps1

3. 本地运行

# 运行服务
go run cmd/server/main.go

开发路线

项目开发按以下优先级进行：

1. 本地基础链路模块: MCP协议适配、本地文件操作、基础权限控制
2. 核心功能模块: UDP统一文档解析引擎、轻量化AI就绪化、本地安全加密
3. 插件化适配模块: 插件封装、性能优化、兼容性测试

许可证

[待定]