PocketFlow MCP Server

A Model Context Protocol (MCP) server that brings the powerful PocketFlow tutorial generation methodology to all AI assistants. Generate comprehensive, beginner-friendly tutorials from any GitHub repository using advanced AI analysis.

What is PocketFlow?

PocketFlow is an innovative methodology for automatically generating high-quality tutorials from codebases. It:

Identifies Core Abstractions - Finds the key concepts and components in a codebase
Maps Relationships - Understands how different parts interact with each other
Orders Explanations - Determines the best sequence to explain concepts
Generates Tutorials - Creates beginner-friendly, step-by-step learning content
Creates Visual Diagrams - Includes Mermaid diagrams for better understanding

Features

✅ Universal AI Assistant Support - Works with Cline, Cursor, Claude Desktop, and any MCP-compatible client
🔍 Deep Repository Analysis - Analyzes GitHub repositories to identify key abstractions
🧠 Intelligent Concept Mapping - Understands relationships between code components
📚 Comprehensive Tutorial Generation - Creates structured, beginner-friendly tutorials
📊 Visual Architecture Diagrams - Generates Mermaid flowcharts and sequence diagrams
🌐 Multi-LLM Provider Support - OpenRouter, Google Gemini, Anthropic Claude, OpenAI
🌍 Multi-Language Support - Generate tutorials in different languages
🔒 Secure & Local - All processing happens locally, API keys stored securely
⚡ Smart Caching - Caches LLM responses for faster subsequent runs

Quick Start

Prerequisites

Node.js 18+
npm or yarn
An API key for your preferred LLM provider

Installation

Clone and Build

git clone https://github.com/tmtcomeup/pocketflow-mcp.git
cd pocketflow-mcp
npm install
npm run build

Configure Your AI Assistant

For Cline (VSCode)

Add to your Cline settings:

{
  "mcpServers": {
    "pocketflow": {
      "command": "node",
      "args": ["path/to/pocketflow-mcp/build/index.js"]
    }
  }
}

For Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "pocketflow": {
      "command": "node", 
      "args": ["path/to/pocketflow-mcp/build/index.js"]
    }
  }
}

Usage

Once connected, you'll have access to these tools:

`analyze_github_repository`

Generate a complete tutorial from any GitHub repository:

// Basic usage
analyze_github_repository({
  repo_url: "https://github.com/microsoft/vscode",
  llm_provider: "openrouter",
  api_key: "sk-or-v1-your-key-here",
  model: "anthropic/claude-3.5-sonnet"
})

// Advanced options
analyze_github_repository({
  repo_url: "https://github.com/pytorch/pytorch", 
  llm_provider: "google",
  api_key: "your-gemini-key",
  model: "gemini-2.5-pro",
  max_abstractions: 8,
  language: "spanish",
  include_patterns: ["*.py", "*.md"],
  exclude_patterns: ["*test*", "*docs/*"]
})

`get_repository_structure`

Explore repository structure before analysis:

get_repository_structure({
  repo_url: "https://github.com/facebook/react",
  include_patterns: ["*.js", "*.jsx", "*.ts"],
  max_depth: 3
})

LLM Provider Setup

OpenRouter (Recommended)

Sign up at openrouter.ai
Get your API key from the dashboard
Access 100+ models including Claude, GPT-4, Gemini, and more

Google Gemini

Get an API key from Google AI Studio
Use models like gemini-2.5-pro or gemini-2.5-flash

Anthropic Claude

Get an API key from console.anthropic.com
Use models like claude-3-5-sonnet-20241022

OpenAI

Get an API key from platform.openai.com
Use models like gpt-4o or gpt-4o-mini

How It Works

The PocketFlow methodology follows a 6-step process:

Repository Fetching - Downloads and filters code files based on patterns
Abstraction Identification - Uses AI to identify 5-10 core concepts in the codebase
Relationship Analysis - Maps how abstractions interact with each other
Chapter Ordering - Determines the optimal learning sequence
Chapter Writing - Generates detailed, beginner-friendly explanations for each concept
Tutorial Compilation - Combines everything into a cohesive tutorial with diagrams

Example Output

The generated tutorial includes:

Index Page with project overview and visual architecture diagram
Individual Chapters for each core abstraction
Mermaid Diagrams showing relationships and workflows
Code Examples with detailed explanations
Cross-References between related concepts
Beginner-Friendly Language with analogies and examples

Configuration Options

Parameter	Description	Default
`repo_url`	GitHub repository URL	Required
`llm_provider`	AI provider (`openrouter`, `google`, `anthropic`, `openai`)	Required
`api_key`	API key for the LLM provider	Required
`model`	Specific model to use	Provider default
`max_abstractions`	Number of key concepts to identify	10
`language`	Tutorial language	"english"
`include_patterns`	File patterns to analyze	Common code files
`exclude_patterns`	File patterns to skip	Tests, docs, builds
`max_file_size`	Maximum file size in bytes	100000
`use_cache`	Enable LLM response caching	true

Contributing

We welcome contributions! Please see our contributing guidelines.

License

MIT License - see LICENSE file for details.

Original PocketFlow

This MCP server is based on the original PocketFlow project by The-Pocket. We've adapted their brilliant methodology to work seamlessly with all MCP-compatible AI assistants.

Support

🐛 Bug Reports: GitHub Issues
💬 Discussions: GitHub Discussions
📖 Documentation: Check this README and inline code comments

Ready to transform any codebase into a comprehensive learning resource? Start analyzing repositories with PocketFlow MCP today!

Install Server

HTTP connection URL

security – no known vulnerabilities

license - not found

quality - confirmed to work

How are these scores calculated?

Tools

Brings the PocketFlow tutorial generation methodology to AI assistants, automatically creating comprehensive, beginner-friendly tutorials from any GitHub repository through advanced codebase analysis.

Related MCP Servers

PyGithub MCP Server
AstroMined
A
security
A
license
A
quality
Enables AI assistants to interact with GitHub through the PyGithub library, providing tools for managing issues, repositories, pull requests, and other GitHub operations with intelligent parameter handling and error management.
Last updated -
19
Python
MIT License
TypeScript Prompt MCP Server
gpaul-mcp
-
security
A
license
-
quality
Provides pre-defined prompt templates for AI assistants to generate comprehensive plans for TypeScript projects, API architectures, and GitHub workflows.
Last updated -
0
TypeScript
MIT License
GitHub MCP Server
renantrendt
-
security
F
license
-
quality
A Model Context Protocol server that enables AI assistants to perform GitHub operations including repository management, file operations, issue tracking, and pull request creation.
Last updated -
1
TypeScript
DocGen MCP Server
rjadhavJT
A
security
A
license
A
quality
Automates the creation of standardized documentation by extracting information from source files and applying templates, with integration capabilities for GitHub, Google Drive, and Perplexity AI.
Last updated -
3
TypeScript
MIT License

View all related MCP servers

PocketFlow MCP Server