Peterparker57 Github MCP Server

🚀 GitHub MCP 服务器

本项目是一个提供 GitHub 集成功能的 Model Context Protocol (MCP) 服务器。该服务器借助 MCP 工具与 GitHub 仓库进行交互，具备仓库管理、文件操作和提交处理等实用功能，能有效提升开发者在 GitHub 上的操作效率。

🚀 快速开始

本服务器可通过 MCP 工具与 GitHub 仓库交互，支持仓库管理、文件操作和提交处理等功能。

✨ 主要特性

• 账户管理和身份验证
• 仓库创建和管理
• 文件操作（读取、写入、推送、拉取）
• 提交操作
• 目录同步
• 仓库比较和差异分析

📦 安装指南

使用以下命令安装服务器：

npm install @modelcontextprotocol/server-github

📚 详细文档

配置

将服务器添加到 MCP 设置文件 (cline_mcp_settings.json) 中：

{
  "mcpServers": {
    "github": {
      "command": "node",
      "args": ["/path/to/github-mcp-server/dist/index.js"],
      "env": {
        "GITHUB_TOKEN_1": "your-github-token",
        "GITHUB_OWNER_1": "your-github-username"
      },
      "disabled": false,
      "alwaysAllow": []
    }
  }
}

可用工具

账户管理

• list_accounts：列出服务器中配置的可用 GitHub 账户。
• select_account：选择一个 GitHub 账户用于后续操作。

仓库管理

• create_repository：创建一个新的 GitHub 仓库。

{
  owner?: string;        // 仓库所有者（可选，如果已选账户）
  name: string;          // 仓库名称
  description: string;   // 仓库描述
  private?: boolean;     // 是否为私有仓库
}

• clone_repository：克隆一个 GitHub 仓库到本地目录。

{
  owner?: string;    // 仓库所有者
  repo: string;      // 仓库名称
  branch?: string;   // 分支名称（默认：main）
  outputDir: string; // 本地克隆的目标目录
}

• rename_repository：重命名一个现有的 GitHub 仓库。

{
  owner?: string;    // 仓库所有者
  repo: string;      // 当前仓库名称
  new_name: string;  // 新的仓库名称
}

文件操作

• push_file：将文件推送到 GitHub 仓库。

{
  owner?: string;     // 仓库所有者
  repo: string;       // 仓库名称
  path: string;       // 仓库中的目标路径
  message: string;    // 提交信息
  sourcePath: string; // 待推送上载的本地文件路径
}

• pull_file：从 GitHub 仓库拉取一个文件。

{
  owner?: string;     // 仓库所有者
  repo: string;       // 仓库名称
  path: string;       // 文件在仓库中的路径
  outputPath: string; // 本地保存文件的路径
}

• sync_directory：实现本地和远程目录之间的双向同步。

{
  owner?: string;    // 仓库所有者
  repo: string;      // 仓库名称
  path: string;      // 仓库中的目标路径
  outputDir: string; // 本地同步的目标目录
}

提交操作

• create_commit：在仓库中创建一个新的提交。

{
  owner?: string;       // 仓库所有者
  repo: string;         // 仓库名称
  branch: string;       // 分支名称
  message: string;      // 提交信息
  author_name: string;  // 提交作者的姓名
  author_email: string; // 提交作者的电子邮件
}

开发

使用以下命令进行开发：

npm run dev

环境变量

📄 许可证

[此处插入许可证信息]