<p align="center">
  <img src="banner.svg" alt="Freya MCP Server" width="100%">
</p>

<p align="center">
  <a href="usecase.png" target="_blank">
    <img src="usecase.png" alt="Showcase" width="600">
    <br>
    <em>Click to view full screenshot</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/license-Custom-00d4aa" alt="License">
  <img src="https://img.shields.io/github/stars/artemij5566-hub/freya-mcp-server?style=flat&logo=github" alt="Stars">
</p>

# Freya MCP Server

**The most powerful filesystem MCP server for AI agents.** Filesystem operations, shell execution, Windows system tools, reverse engineering, code intelligence (LSP), browser automation, and agent orchestration. All in one MCP server built for AI agents like Claude, Cline, and Cursor.

Outperforms Claude Code in raw filesystem capabilities with native Windows support, real process control, memory operations, and DLL injection.

## Why Freya?

Claude Code runs in a sandbox. Freya gives the agent real system access. Read process memory. Patch binaries. Walk the registry. Inject DLLs. Control Windows services. Full LSP integration for real code intelligence. This is a real engineering tool, not a toy.

## Features

**Filesystem** - Read, write, move, copy, delete with atomic writes, SHA-256 conflict detection, path traversal protection, and backup history.

**Shell and Processes** - Execute commands with permission gating, durable background jobs, streaming output, injection-safe sanitization, and smart timeouts.

**Windows System Tools** - Registry (read, write, search, delete). Process management (list, kill, suspend, resume). Windows Services (start, stop, list). DLL injection. ETW tracing.

**Reverse Engineering** - Process memory read/write/scan with AOB patterns. Module enumeration. PE analysis (headers, exports, imports, sections). Hook detection and signature verification.

**Code Intelligence** - Full LSP integration with go-to-definition, references, hover, symbols, diagnostics, and workspace-wide rename with validation pipelines.

**Agent Orchestration** - Durable task/job management, todo system, context compression, project memory, and multi-agent orchestration with persistent agents.

**Browser and Web** - Playwright automation, clipboard access, file downloads, HTTP requests, web scraping.

**Security** - Permission-gated operation tiers, shell command sanitization, path-traversal protection, and tool profiles (daily, full, coding, reverse, minimal).

## Quick Start

```bash
git clone https://github.com/artemij5566-hub/freya-mcp-server.git
cd freya-mcp-server
npm install
cp .env.example .env
npm start
```

## Use with Claude Desktop, Cline, or Cursor

Add to your `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"
      }
    }
  }
}
```

## Requirements

- Node.js >= 22
- Windows (for system tools and reverse engineering)

## Development

```bash
npm run dev       # Watch mode with HTTP dashboard
npm run build     # Build TypeScript and native addon
npm run test      # Run tests
npm run check     # Typecheck, test, lint, build
```

## License

Custom license. See [LICENSE](LICENSE) for details.