Project Hub MCP Server

An MCP server providing comprehensive project management, local Git functionality, and GitHub integration capabilities. This server enables managing local projects, tracking changes, creating local commits, and synchronizing with GitHub repositories.

Features

Project Management

• Project creation and management with flexible, case-insensitive, partial name search
• Source file scanning and monitoring with customizable exclusion patterns
• Project metadata tracking and updates

Local Git Functionality

• Local commit creation and management without requiring GitHub
• Branch management (create, switch, list)
• File snapshots with metadata (size, creation time, modification time)
• Restore functionality to revert to previous commits or branches
• Clone functionality to create new instances from commits or branches

Change Tracking

• Record and track changes with associated files
• Categorize changes by type (feature, fix, refactor, etc.)
• Link changes to commits for comprehensive history

Notes System

• Create and manage project notes with rich markdown content
• Categorize and tag notes for better organization
• Search functionality to find relevant documentation

GitHub Integration

• Repository management (create, update, delete, rename)
• Commit management with file content tracking
• Branch operations (create, delete, merge)
• Pull request creation and management
• Repository cloning and local setup
• Multi-account GitHub support

Tools

Project Management

create_project

Create a new project with local and remote repository management.

• name: Project name
• path: Local project path
• type: Project type
• description: Project description

find_project

Find a project by name (flexible, case-insensitive, partial match). Returns detailed project information including changes and notes.

• name: Project name to search for

list_projects

List all projects with optional filtering.

• type: Filter by project type (optional)
• has_repo: Filter by repository presence (optional)
• page: Page number for pagination (optional)
• page_size: Number of items per page (optional)

update_project_details

Update details of an existing project.

• projectId: Project ID
• name: New project name (optional)
• path: New project path (optional)
• type: New project type (optional)
• description: New project description (optional)
• status: New project status (optional)

delete_project

Delete a project.

• projectId: Project ID

scan_project_files

Scan a project directory for source files and update the project record.

• projectId: Project ID
• excludePatterns: Regex patterns to exclude files (optional)

projectdb_location

Get the full path of the project database location.

Change Management

record_change

Record a change in a project.

• projectId: Project ID
• type: Change type
• description: Change description
• files: List of file paths affected by this change (optional)

get_pending_changes

Get pending changes for a project.

• projectId: Project ID

clear_committed_changes

Clear committed changes for a project.

• projectId: Project ID

Local Git Functionality

init_local_repository

Initialize a local Git repository for a project.

• projectId: Project ID

create_local_commit

Create a local commit from pending changes.

• projectId: Project ID
• message: Commit message
• authorName: Author name (optional)
• authorEmail: Author email (optional)

get_local_commit_history

Get local commit history for a project.

• projectId: Project ID

create_local_branch

Create a new local branch.

• projectId: Project ID
• name: Branch name
• startingCommitId: Starting commit ID (optional)

switch_local_branch

Switch to a different local branch.

• projectId: Project ID
• branchName: Branch name

... View full README on GitHub