Project Hub

You run and integrate the Project Hub MCP Server to manage local projects, track changes, and synchronize with GitHub. This MCP server connects your local workflow with GitHub, enabling centralized project management, version control, and automated collaboration features.

How to use

You interact with the Project Hub MCP Server through an MCP client. Use it to create and manage projects, record and review changes, link repositories, and perform commit operations that reflect your team’s work across local environments and GitHub.

How to install

# prerequisites: Node.js installed on your system
# 1) Clone the project hub MCP server repository
# (Assuming you have the repository available locally)
# Replace with your actual clone URL if needed
git clone https://github.com/yourusername/project-hub-mcp-server.git
cd project-hub-mcp-server

# 2) Install dependencies
npm install

# 3) Build the project
npm run build

Configuration

Configure the MCP client to load and run the Project Hub MCP Server by adding a command configuration that starts the local server process.

{
  "mcpServers": {
    "project_hub": {
      "command": "node",
      "args": ["path/to/project-hub-mcp-server/dist/index.js"],
      "env": {
        "DEFAULT_OWNER": "your-github-username",
        "GITHUB_TOKEN_your-github-username": "your-github-token"
      }
    }
  }
}

Usage tips and patterns

• Start the MCP server using the command and environment variables defined in your MCP settings. - Use the client to create projects, link GitHub repositories, and push changes with associated commit messages. - When you record changes or create commits, the MCP server will organize and track changes across your local files and linked GitHub repos.

Configuration and commands details

The server can be configured to run locally in your environment. The provided configuration snippet shows how to wire the Node runtime to execute the server entry point and supply a GitHub owner and token for authentication.

Notes on environment and usage

• Ensure Node.js is installed on the host where you run the MCP server. - Keep your GitHub token secure and rotate it as needed. - Use unique owner values per GitHub account to avoid conflicts when using multiple accounts.

Troubleshooting

If you encounter connection issues, verify that the Node process starts correctly and that the environment variables are accessible to the running process. Check that the path to dist/index.js is valid after the build step and that your MCP client is configured to point to the correct server instance.

Security considerations

Treat GitHub tokens as secrets. Store them securely, grant least privilege where possible, and avoid committing tokens to code or logs. Rotate credentials periodically and monitor for unusual activity on linked repositories.

Examples of common workflows

• Create a new project with a local path and optional description, then link it to a GitHub repository for automatic syncing of changes. - Record changes to files, categorize them (feature, bugfix, etc.), and attach affected files for traceability. - Create commits that bundle multiple file changes and push them to the associated GitHub repository through the MCP server.

Available tools

create_project

Create a new project with local and remote repository management.

get_project

Get project details including repository info.

list_projects

List all projects with optional filtering.

delete_project

Delete a project.

record_change

Record a change to a project.

get_pending_changes

Get uncommitted changes for a project.

clear_committed_changes

Mark changes as committed with a specific commit SHA.

list_accounts

List available GitHub accounts.

set_github_account

Add or update a GitHub account.

select_account

Select a GitHub account to use.

create_repository

Create a new GitHub repository.

link_repository

Link a GitHub repository to a project.

clone_repository

Clone a GitHub repository.

rename_repository

Rename a GitHub repository.

delete_repository

Delete a GitHub repository.

get_file

Get a file from a GitHub repository.

create_commit

Create a commit with multiple file changes.

list_commits

List commits in a repository.

get_commit

Get details of a specific commit.

revert_commit

Revert a commit.

scan_source_files

Scan and update source files for a project.

record_source_change

Record a change to a source file.

update_source_settings

Update source file tracking settings for a project.