Project Hub MCP Server

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

Features

• Project creation and management
• Change tracking and version control
• GitHub repository integration
• Source file scanning and monitoring
• Automated commit management
• 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

get_project

Get project details including repository info.

• name: Project name

list_projects

List all projects with optional filtering.

• type: Filter by project type (optional)
• has_repo: Filter by repository presence (optional)

delete_project

Delete a project.

• name: Project name

Change Management

record_change

Record a change to a project.

• project_name: Project name
• description: Description of the change
• files: Files affected by the change (optional)
• type: Type of change (e.g., feature, bugfix, refactor) (optional)

get_pending_changes

Get uncommitted changes for a project.

• project_name: Project name

clear_committed_changes

Mark changes as committed with a specific commit SHA.

• project_name: Project name
• commit_sha: SHA of the commit

GitHub Account Management

list_accounts

List available GitHub accounts.

set_github_account

Add or update a GitHub account.

• owner: GitHub account owner
• token: GitHub personal access token

select_account

Select a GitHub account to use.

• owner: GitHub account owner

Repository Management

create_repository

Create a new GitHub repository.

• name: Repository name
• description: Repository description
• private: Whether the repository is private (optional)

link_repository

Link a GitHub repository to a project.

• project_name: Project name
• repo_owner: Repository owner
• repo_name: Repository name

clone_repository

Clone a GitHub repository.

• repo: Repository name
• output_dir: Output directory
• branch: Branch to clone (optional)

rename_repository

Rename a GitHub repository.

• repo: Current repository name
• new_name: New repository name

delete_repository

Delete a GitHub repository.

• name: Repository name

File Operations

get_file

Get a file from a GitHub repository.

• repo: Repository name
• path: File path
• branch: Branch name (optional)

Commit Operations

create_commit

Create a commit with multiple file changes.

• repo: Repository name
• changes: Array of file changes (path, operation, sourcePath)
• message: Commit message
• branch: Target branch (optional)
• author: Author details (optional)

list_commits

List commits in a repository.

• repo: Repository name
• branch: Branch name (optional)
• path: File path filter (optional)
• since: Start date (optional)
• until: End date (optional)
• author: Author filter (optional)

get_commit

Get details of a specific commit.

• repo: Repository name
• sha: Commit SHA

revert_commit

Revert a commit.

• repo: Repository name
• sha: Commit SHA to revert
• message: Revert commit message
• branch: Target branch (optional)

Source File Management

scan_source_files

Scan and update source files for a project.

• project_name: Project name

record_source_change

Record a change to a source file.

• project_name: Project name
• file_path: Path to the changed file
• description: Description of the change
• type: Type of change (feature, bugfix, refactor, documentation, other)
• lines: Changed lines with start, end, content, and operation

update_source_settings

Update source file tracking settings for a project.

• project_name: Project name
• auto_commit: Whether to auto-commit changes (optional)
• ignore_patterns: Patterns to ignore during file scanning (optional)

Installation

1. Clone the repository:

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

Add the server to your MCP settings file:

{
  "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 Examples

Project Management

// Create a new project
await mcp.use("project-hub", "create_project", {
  name: "my-project",
  path: "./projects/my-project",
  type: "typescript",
  description: "A new TypeScript project"
});

// Record a change
await mcp.use("project-hub", "record_change", {
  project_name: "my-project",
  description: "Added new feature",
  type: "feature",
  files: ["src/feature.ts"]
});

GitHub Integration

// Create and link repository
await mcp.use("project-hub", "create_repository", {
  name: "my-project",
  description: "A new TypeScript project",
  private: true
});

await mcp.use("project-hub", "link_repository", {
  project_name: "my-project",
  repo_owner: "your-username",
  repo_name: "my-project"
});

// Create a commit
await mcp.use("project-hub", "create_commit", {
  repo: "my-project",
  changes: [{
    path: "src/feature.ts",
    operation: "add",
    sourcePath: "./projects/my-project/src/feature.ts"
  }],
  message: "feat: add new feature"
});

Development

1. Make changes to the source code
2. Run tests:

npm test

3. Build the project:

npm run build

Contributing

1. Fork the repository
2. Create your feature branch
3. Commit your changes
4. Push to the branch
5. Create a Pull Request

License

MIT