CodeWeaver MCP Server

Transform your entire codebase into a single, AI-readable Markdown document through the Model Context Protocol.

CodeWeaver MCP Server brings powerful code packaging capabilities to AI assistants like Claude Code. It converts complex project structures into clean, navigable Markdown files - perfect for code reviews, documentation, AI analysis, and sharing with teams.

Why CodeWeaver MCP?

🚀 Seamless AI Integration

Native MCP Protocol: Works out-of-the-box with Claude Code and other MCP-compatible AI assistants
Zero Context Switching: Access codebase packaging directly from your AI workflow
Instant Results: Get Markdown output immediately or save to file

📦 Complete Codebase Visibility

Full Structure Capture: Beautiful tree-view of your entire project hierarchy
All Code Included: Every file's content embedded with proper syntax highlighting
Smart Filtering: Respects .gitignore and supports custom ignore patterns

💡 Perfect for Multiple Use Cases

For AI Analysis

Feed entire codebases to AI models (ChatGPT, Claude, etc.)
Enable comprehensive code understanding without manual file sharing
Perfect for code reviews and refactoring discussions

For Documentation

Generate instant project snapshots
Create shareable codebase documentation
Archive project states at key milestones

For Team Collaboration

Share complete project context with teammates
Onboard new developers faster
Facilitate remote code discussions

For Code Reviews

Package pull requests with full context
Review entire features in one document
Track code changes across multiple files

Features

🎯 Pure TypeScript Implementation

No External Dependencies: Built entirely in TypeScript - no Go, Python, or other runtimes required
Fast & Lightweight: Efficient file scanning and processing
Cross-Platform: Works on macOS, Linux, and Windows

🛠️ Powerful Customization

Flexible Filtering: Include/exclude files with glob patterns
Gitignore Support: Automatically respects your .gitignore rules
Custom Patterns: Add project-specific ignore patterns
Multiple Output Modes: Return content directly or save to file

📝 Smart Markdown Output

Syntax Highlighting: Automatic language detection for 20+ programming languages
Clean Formatting: Professional tree structure using box-drawing characters
Organized Layout: Logical file ordering (directories first, alphabetical)
Relative Paths: Clear file location references

Installation

Prerequisites

Node.js 18 or later
npm or yarn

Quick Install

# Clone and build
git clone https://github.com/yourusername/codeweaver-mcp-server.git
cd codeweaver-mcp-server
npm install
npm run build

Add to Claude Code

claude mcp add codeweaver node /absolute/path/to/codeweaver-mcp-server/dist/index.js

Or manually add to ~/.claude/config.json:

{
  "mcpServers": {
    "codeweaver": {
      "command": "node",
      "args": ["/absolute/path/to/codeweaver-mcp-server/dist/index.js"]
    }
  }
}

Usage

Basic Usage

Pack current directory:

codeweaver_pack_codebase({
  path: "."
})

Save to File

codeweaver_pack_codebase({
  path: "./src",
  output: "codebase.md"
})

Include Gitignored Files

codeweaver_pack_codebase({
  path: ".",
  include_gitignored: true
})

Custom Ignore Patterns

codeweaver_pack_codebase({
  path: ".",
  ignore_patterns: ["*.log", "tmp/*", "*.tmp"]
})

Output Format

CodeWeaver generates clean, structured Markdown:

# project-name

## Directory Structure

├── src │ ├── index.ts │ └── utils.ts └── package.json


## Files

### src/index.ts

```typescript
// Full file content with syntax highlighting
import { helper } from './utils';
...

src/utils.ts

// Full file content
export function helper() { ... }


## Supported Languages

Automatic syntax highlighting for:
- TypeScript/JavaScript (`.ts`, `.tsx`, `.js`, `.jsx`)
- Python (`.py`)
- Go (`.go`)
- Rust (`.rs`)
- Java (`.java`)
- C/C++ (`.c`, `.cpp`, `.h`, `.hpp`)
- C# (`.cs`)
- Ruby (`.rb`)
- PHP (`.php`)
- Swift (`.swift`)
- Kotlin (`.kt`)
- SQL (`.sql`)
- Shell (`.sh`)
- YAML (`.yaml`, `.yml`)
- JSON (`.json`)
- XML (`.xml`)
- HTML (`.html`)
- CSS (`.css`)
- Markdown (`.md`)

## Default Ignore Patterns

CodeWeaver automatically skips:
- `node_modules/`
- `.git/`
- `dist/` and `build/`
- `.next/` and `.nuxt/`
- `vendor/`
- Python virtual environments (`venv/`, `.venv/`, `__pycache__/`)
- System files (`.DS_Store`, `Thumbs.db`)

## Real-World Examples

### Example 1: Share Code with ChatGPT
```typescript
// Pack your project
codeweaver_pack_codebase({
  path: "./my-app",
  output: "my-app-context.md"
})

// Copy the Markdown file content and paste into ChatGPT
// Now ChatGPT can see your entire codebase!

Example 2: Code Review Documentation

// Pack only source code
codeweaver_pack_codebase({
  path: "./src",
  ignore_patterns: ["*.test.ts", "*.spec.ts"],
  output: "review-package.md"
})

Example 3: Project Snapshot

// Capture complete project state
codeweaver_pack_codebase({
  path: ".",
  output: `snapshot-${new Date().toISOString()}.md`
})

API Reference

`codeweaver_pack_codebase`

Parameters:

Parameter	Type	Required	Default	Description
`path`	string	✅ Yes	-	Directory path to pack
`output`	string	❌ No	-	Output file path (returns content if omitted)
`include_gitignored`	boolean	❌ No	`false`	Include files listed in `.gitignore`
`ignore_patterns`	string[]	❌ No	`[]`	Additional glob patterns to ignore

Returns:

If output specified: Success message with file path and size
If output omitted: Complete Markdown content

Error Handling:

"Error: Path does not exist" - Invalid directory path
"Error: Path is not a directory" - Path points to a file
Binary files automatically skipped with notice

Development

Build from Source

npm install
npm run build

Development Mode

npm run dev

Clean Build

npm run clean
npm run build

Why Choose CodeWeaver MCP?

✅ For AI-First Workflows: Built specifically for AI tools, unlike generic file packers ✅ Zero Configuration: Works immediately with sensible defaults ✅ Professional Output: Clean, readable Markdown that humans and AI love ✅ Modern Stack: Pure TypeScript, no legacy dependencies ✅ Active Development: Regularly updated with new features ✅ MIT Licensed: Free for personal and commercial use

Comparison with Alternatives

Feature	CodeWeaver MCP	Command-line tools	VSCode Extensions
AI Integration	✅ Native MCP	❌ Manual copy-paste	⚠️ Limited
Zero Config	✅ Yes	❌ Complex flags	✅ Yes
Cross-Platform	✅ Yes	⚠️ Varies	⚠️ VSCode only
Real-time Use	✅ Yes	❌ No	⚠️ Limited
TypeScript Native	✅ Yes	❌ Various	⚠️ Varies

Contributing

Contributions welcome! Please feel free to submit issues or pull requests.

License

MIT License - see LICENSE file for details

Acknowledgments

Inspired by the original CodeWeaver project and adapted for the Model Context Protocol ecosystem.

Made with ❤️ for the AI development community