Skip to main content
Glama

CodeWeaver MCP Server

TypeScript MCP License: MIT

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

English | 简体中文

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

-
security - not tested
A
license - permissive license
-
quality - not tested

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/99hansling/codeweaver-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server