Peterparker57 Project Hub MCP Server

🚀 項目中心 MCP 服務器

項目中心 MCP 服務器提供項目管理和 GitHub 集成功能，能管理本地項目、跟蹤更改並同步到 GitHub 倉庫，為項目管理帶來便利。

🚀 快速開始

安裝與配置

1. 克隆項目倉庫：

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

2. 配置環境變量：

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

3. 啟動服務器：

node dist/index.js

開發步驟

1. 修改源代碼
2. 運行測試：

npm test

3. 構建項目：

npm run build

✨ 主要特性

• 項目創建與管理
• 變更跟蹤與版本控制
• GitHub 倉庫集成
• 源文件掃描與監控
• 自動提交管理
• 多賬戶 GitHub 支持

📦 安裝指南

安裝步驟

1. 克隆項目倉庫：

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

2. 配置環境變量：

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

3. 啟動服務器：

node dist/index.js

💻 使用示例

基礎用法

項目管理

// 創建新項目
await mcp.use("project-hub", "create_project", {
  name: "my-project",
  path: "./projects/my-project",
  type: "typescript",
  description: "一個全新的 TypeScript 項目"
});

// 記錄變更
await mcp.use("project-hub", "record_change", {
  project_name: "my-project",
  description: "添加新功能",
  type: "feature",
  files: ["src/feature.ts"]
});

GitHub 集成

// 創建並關聯倉庫
await mcp.use("project-hub", "create_repository", {
  name: "my-project",
  description: "一個全新的 TypeScript 項目",
  private: true
});

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

// 創建提交
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: 添加新功能"
});

📚 詳細文檔

工具

項目管理

create_project

創建一個新的項目，具備本地和遠程倉庫管理功能。

• name: 項目名稱
• path: 本地項目路徑
• type: 項目類型
• description: 項目描述

get_project

獲取項目的詳細信息，包括倉庫信息。

• name: 項目名稱

list_projects

列出所有項目，可選過濾功能。

• name: 項目名稱

delete_project

刪除指定的項目。

• name: 項目名稱

GitHub 賬戶管理

create_repository

創建一個新的 GitHub 倉庫。

• name: 倉庫名稱
• description: 倉庫描述
• private: 是否為私有倉庫（可選）

link_repository

將本地項目與 GitHub 倉庫關聯。

• project_name: 項目名稱
• repo_owner: GitHub 賬戶名
• repo_name: 倉庫名稱

提交管理

create_commit

向指定的倉庫創建提交。

• repo: 倉庫名稱
• changes: 變更列表，包含路徑、操作和源路徑
• message: 提交信息

🤝 貢獻指南

1. Fork 倉庫
2. 創建功能分支
3. 提交更改
4. 推送到分支
5. 創建 Pull Request

📄 許可證

MIT