Peterparker57 Project Hub MCP Server

🚀 Project Hub MCP Server

A MCP server that offers project management and GitHub integration features. This server can manage local projects, track changes, and synchronize them to GitHub repositories.

✨ Features

• Project creation and management
• Change tracking and version control
• GitHub repository integration
• Source file scanning and monitoring
• Automatic commit management
• Support for multiple GitHub accounts

🛠️ Tools

Project Management

create_project

Create a new project with local and remote repository management capabilities.

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

get_project

Retrieve detailed information about a project, including repository details.

• name: Project name

list_projects

List all projects, with optional filtering.

• name: Project name

delete_project

Delete a specified project.

• name: Project name

GitHub Account Management

create_repository

Create a new GitHub repository.

• name: Repository name
• description: Repository description
• private: Whether it's a private repository (optional)

link_repository

Associate a local project with a GitHub repository.

• project_name: Project name
• repo_owner: GitHub account name
• repo_name: Repository name

Commit Management

create_commit

Create a commit to a specified repository.

• repo: Repository name
• changes: List of changes, including path, operation, and source path
• message: Commit message

📦 Installation and Configuration

1. Clone the project repository:

git clone https://github.com/yourusername/project-hub-mcp-server.git

2. Configure environment variables:

export DEFAULT_OWNER=your-github-username
export GITHUB_TOKEN_your-github-username=your-github-token

3. Start the server:

node dist/index.js

💻 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 brand new TypeScript project"
});

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

GitHub Integration

// Create and link a repository
await mcp.use("project-hub", "create_repository", {
  name: "my-project",
  description: "A brand 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. Modify the source code.
2. Run tests:

npm test

3. Build the project:

npm run build

🤝 Contribution Guidelines

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

📄 License

MIT