Project Hub MCP Server

What is Project Hub MCP Server?

Project Hub MCP Server is an MCP server that provides comprehensive project management, local Git functionality, and GitHub integration capabilities. It enables managing local projects, tracking changes, creating local commits, and synchronizing with GitHub repositories. It is intended for developers using MCP-compatible clients.

How to use Project Hub MCP Server?

Clone the repository, install dependencies with npm install, and build with npm run build. Then add the server to your MCP settings file with the required environment variables (GITHUB_TOKEN, GIT_PATH, etc.) and optionally list safe tools under alwaysAllow.

Key features of Project Hub MCP Server

• Project creation and management with flexible, case-insensitive, partial name search
• Local commit creation and management without requiring GitHub
• Branch management (create, switch, list) locally and on GitHub
• Change tracking with types (feature, fix, refactor, etc.)
• Rich note system with markdown content and search
• Full GitHub repository, commit, branch, and pull request management
• File snapshot system with metadata and content retrieval
• Multi-account GitHub support

Use cases of Project Hub MCP Server

• Managing multiple local projects with version control and metadata
• Tracking changes and creating local commits without a remote repository
• Synchronizing local work with GitHub repositories
• Organizing project documentation with searchable notes
• Automating repository operations (create, fork, transfer, rename) via MCP

FAQ from Project Hub MCP Server

What runtime and dependencies are required?

Node.js and npm are required. The server uses SQLite for local data storage and requires a local Git installation (specified via GIT_PATH environment variable).

How do I authenticate with GitHub?

Set the GITHUB_TOKEN environment variable with a valid GitHub personal access token. The token must have appropriate scopes for repository and pull request operations.

Where does the server store data?

Project metadata, changes, notes, local commits, branches, and file snapshots are stored in a local SQLite database. The database location can be retrieved via the projectdb_location tool.

Does this server support OAuth or other transports?

No. The README only configures the server via the MCP stdio transport (using command and args). Authentication is token-based (GitHub token) and no other transports are described.

Can I work offline with local Git features?

Yes. Local commit creation, branch management, and file snapshots work entirely offline. You only need network connectivity for GitHub integration features like pushing commits or managing remote repositories.