项目中心 MCP 服务器

一个提供项目管理和 GitHub 集成功能的MCP服务器。此服务器可以管理本地项目、跟踪更改并同步到GitHub仓库。

特性

• 项目创建与管理
• 变更跟踪与版本控制
• GitHub 仓库集成
• 源文件扫描与监控
• 自动提交管理
• 多账户 GitHub 支持

工具

项目管理

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. 克隆项目仓库：

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: 添加新功能"
});

开发

1. 修改源代码
2. 运行测试：

npm test

3. 构建项目：

npm run build

贡献指南

1. Fork 仓库
2. 创建功能分支
3. 提交更改
4. 推送到分支
5. 创建 Pull Request

许可证

MIT