内容
<p align="center">
<img src="banner.svg" alt="Freya MCP 服务器" width="100%">
</p>
<p align="center">
<a href="usecase.png" target="_blank">
<img src="usecase.png" alt="展示" width="600">
<br>
<em>点击查看完整截图</em>
</a>
</p>
<p align="center">
<img src="https://img.shields.io/badge/Node.js-22%2B-339933?logo=nodedotjs" alt="Node.js">
<img src="https://img.shields.io/badge/TypeScript-5.6-3178C6?logo=typescript" alt="TypeScript">
<img src="https://img.shields.io/badge/许可证-自定义-00d4aa" alt="许可证">
<img src="https://img.shields.io/github/stars/artemij5566-hub/freya-mcp-server?style=flat&logo=github" alt="星标">
</p>
# Freya MCP 服务器
**最强大的 AI 代理文件系统 MCP 服务器。** 文件系统操作、shell 执行、Windows 系统工具、逆向工程、代码智能（LSP）、浏览器自动化和代理编排。所有功能都集成在一个 MCP 服务器中，适用于 Claude、Cline 和 Cursor 等 AI 代理。
在原始文件系统功能方面优于 Claude Code，具有原生 Windows 支持、真正的进程控制、内存操作和 DLL 注入。
## 为什么选择 Freya？
Claude Code 在沙箱中运行。Freya 为代理提供真正的系统访问权限。读取进程内存。修补二进制文件。遍历注册表。注入 DLL。控制 Windows 服务。完整的 LSP 集成，提供真正的代码智能。这是一个真正的工程工具，而不是玩具。
## 功能
**文件系统** - 读取、写入、移动、复制、删除，支持原子写入、SHA-256 冲突检测、路径遍历保护和备份历史。
**Shell 和进程** - 执行命令，支持权限控制、持久后台作业、流式输出、注入安全净化 和智能超时。
**Windows 系统工具** - 注册表（读取、写入、搜索、删除）。进程管理（列表、终止、暂停、恢复）。Windows 服务（启动、停止、列表）。DLL 注入。ETW 跟踪。
**逆向工程** - 进程内存读取/写入/扫描，支持 AOB 模式。模块枚举。PE 分析（头部、导出、导入、节）。钩子检测和签名验证。
**代码智能** - 与 LSP 完全集成，支持跳转到定义、引用、悬停、符号、诊断 和工作区范围的重命名，带有验证管道。
**代理编排** - 持久任务/作业管理、待办事项系统、上下文压缩、项目内存 和多代理编排，支持持久代理。
**浏览器和网页** - Playwright 自动化、剪贴板访问、文件下载、HTTP 请求、网页抓取。
**安全** - 权限控制的操作层级、shell 命令净化、路径遍历保护 和工具配置文件（每日、完整、编码、逆向、最小）。
## 快速开始
```bash
git clone https://github.com/artemij5566-hub/freya-mcp-server.git
cd freya-mcp-server
npm install
cp .env.example .env
npm start
```
## 与 Claude Desktop、Cline 或 Cursor 配合使用
在 `claude_desktop_config.json` 中添加：
```json
{
"mcpServers": {
"freya": {
"command": "node",
"args": ["path/to/freya-mcp-server/dist/index.v2.js"],
"env": {
"ALLOWED_ROOT": "C:\\Projects",
"FREYA_TOOL_PROFILE": "full"
}
}
}
}
```
## 要求
- Node.js >= 22
- Windows（用于系统工具和逆向工程）
## 开发
```bash
npm run dev # 监视模式，带有 HTTP 仪表板
npm run build # 构建 TypeScript 和原生插件
npm run test # 运行测试
npm run check # 类型检查、测试、 lint、构建
```
## 许可证
自定义许可证。详情请参见 [LICENSE](LICENSE)。
