#Docs-Reel MCP

The docs-reel MCP server gives Claude Code filesystem access to the Reel desktop app's documentation directory (~/code/reel/docs). It uses the standard @modelcontextprotocol/server-filesystem package — no custom code, just a read/write bridge to the docs folder.

Reel is Eko's standalone AI video generator (Tauri 2.x + React + Rust) that turns text content into professional marketing videos through a 5-stage pipeline.

#Setup

The server is configured in user-level Claude settings (not .mcp.json) since it references a path outside the Eko monorepo:

{
  "docs-reel": {
    "type": "stdio",
    "command": "npx",
    "args": [
      "-y",
      "@modelcontextprotocol/server-filesystem",
      "/Users/jonathansteele/code/reel/docs"
    ]
  }
}

Prerequisites:

• The Reel repo must be cloned at ~/code/reel/
• npx must be available (Node.js installed)

#Tools

All tools operate within the allowed directory (~/code/reel/docs) and its subdirectories.

#Reading

Tool	Purpose
list_allowed_directories	Confirm which root directories are accessible
list_directory	List files and subdirectories at a path (with [FILE]/[DIR] prefixes)
list_directory_with_sizes	Same as above but includes file sizes, sortable by name or size
directory_tree	Recursive JSON tree of the full directory structure
read_text_file	Read a file's full text content
read_multiple_files	Read several files in one call
read_media_file	Read image/audio files as base64
get_file_info	File metadata (size, timestamps, permissions)

#Writing

Tool	Purpose
write_file	Create or overwrite a file
edit_file	Line-based find-and-replace edits with diff preview
create_directory	Create directories (including nested)
move_file	Move or rename files and directories

#Search

Tool	Purpose
search_files	Search file contents by pattern

#Directory Structure

~/code/reel/docs/
  the-reel-bible.md                        # Product vision and architecture overview
  character-studio-guide.md                # Character creation and management guide
  script-and-scene-prompting-guide.md      # Prompting guide for video scripts and scenes

  specs/
    reel-video-generator-spec.md           # Full technical specification
    reel-faq.md                            # Solopreneur-targeted FAQ
    reel-requirements.md                   # Build prerequisites and open decisions
    reel-rollout-checklist.md              # Deployment checklist
    reel/                                  # Cast system specs (casting, voice groups)

  plans/                                   # Date-stamped design + implementation plans
    2026-02-27-phase-1a-core-pipeline.md   # Core pipeline architecture
    2026-02-28-ui-redesign.md              # UI redesign plan
    2026-02-28-stage3-visual-production.md # Visual asset generation
    2026-02-28-stage4-audio-production.md  # Audio asset generation
    2026-02-28-stage5-render-dispatch.md   # RunPod render dispatch
    2026-03-01-*.md                        # Library, queue, batch, characters pages
    2026-03-02-character-studio.md         # Character studio feature
    ...

  product/
    USER-GUIDE.md                          # End-user product guide

  video-ideas/
    eko-ad-concepts.md                     # Marketing video concepts for Eko
    workflow-guide.md                      # Video production workflow guide

  project-eko/                             # Eko-specific integration docs
  projects/                                # Cross-project references
  reports/                                 # Generated reports

#Common Tasks

#Browse the docs tree

"Show me the Reel docs structure"
→ directory_tree { path: "/Users/jonathansteele/code/reel/docs" }

#Read a specification

"Read the Reel bible"
→ read_text_file { path: "/Users/jonathansteele/code/reel/docs/the-reel-bible.md" }

#Check what plans exist

"List all Reel implementation plans"
→ list_directory { path: "/Users/jonathansteele/code/reel/docs/plans" }

#Read multiple files at once

"Read the character studio guide and the prompting guide"
→ read_multiple_files {
    paths: [
      "/Users/jonathansteele/code/reel/docs/character-studio-guide.md",
      "/Users/jonathansteele/code/reel/docs/script-and-scene-prompting-guide.md"
    ]
  }

#Write a new plan or doc

"Create a new plan for the settings page"
→ write_file {
    path: "/Users/jonathansteele/code/reel/docs/plans/2026-03-28-settings-page.md",
    content: "..."
  }

#Edit an existing doc

"Update the rollout checklist to mark Stage 3 as complete"
→ edit_file {
    path: "/Users/jonathansteele/code/reel/docs/specs/reel-rollout-checklist.md",
    edits: [{ oldText: "- [ ] Stage 3", newText: "- [x] Stage 3" }]
  }

#Reel Pipeline Context

The docs-reel MCP is most useful when working on Reel features that need specification or planning context. The Reel video pipeline has 5 stages:

Stage	Technology	Output
1. Extraction	Claude / GPT-4	VideoBrief
2. Script	Claude / GPT-4	VideoScript (timestamped scenes)
3. Visual	Runway, Playwright, Remotion	VisualAsset[]
4. Audio	ElevenLabs	AudioAsset[]
5. Render	RunPod GPU + Remotion + FFmpeg	RenderOutput

Schema definitions live in the Eko monorepo at packages/reel-schemas/, and the render worker at apps/worker-reel-render/.

#Related Resources

Resource	Location
Reel schemas	packages/reel-schemas/ (Eko monorepo)
Render worker	apps/worker-reel-render/ (Eko monorepo)
Archived Eko-side reel docs	docs/docs_archive/reel_archive/ (Eko monorepo)