🔗 GitHub MCP Server for Claude Desktop

🔗 GitHub MCP Server for Claude Desktop

site icon
2025.03.24 0
JavaScriptGitHub 集成git 命令自然语言交互开发效率
GitHub MCP Server 是一个为 Claude Desktop 设计的集成工具,旨在通过自然语言对话实现与 GitHub 仓库和 git 命令的无缝交互。它提供了克隆仓库、检查状态、浏览仓库、获取仓库信息、提交更改、推送更改以及创建新仓库等功能,极大地提升了开发效率。
View on GitHub

Overview

基本能力

产品定位

GitHub MCP Server 是一个为 Claude Desktop 设计的集成工具,旨在通过自然语言对话实现与 GitHub 仓库和 git 命令的无缝交互。

核心功能

  • 🔄 git-clone - 克隆任何仓库
  • 📊 git-status - 检查 git 仓库状态
  • 📋 github-list-repos - 浏览 GitHub 仓库
  • 🔍 github-repo-info - 获取仓库详细信息
  • 📝 git-commit - 提交更改
  • 🚀 git-push - 推送更改到 GitHub
  • 🆕 github-create-repo - 创建新仓库

适用场景

  • 通过自然语言命令管理 GitHub 仓库
  • 快速克隆和检查仓库状态
  • 自动化提交和推送更改
  • 创建新仓库

工具列表

  • git-clone:克隆仓库
  • git-status:检查仓库状态
  • github-list-repos:列出仓库
  • github-repo-info:获取仓库信息
  • git-commit:提交更改
  • git-push:推送更改
  • github-create-repo:创建新仓库

常见问题解答

  • 如何添加 GitHub Token?
  • 创建 .github_token 文件
  • 设置 GITHUB_TOKEN 环境变量
  • 直接在 Claude 配置中添加

使用教程

使用依赖

  • Node.js 16+
  • Git 命令行工具
  • Claude Desktop
  • GitHub Personal Access Token

安装教程

  1. 克隆仓库: bash git clone https://github.com/shibdad/github-mcp-server.git cd github-mcp-server
  2. 安装依赖: bash npm install
  3. 设置可执行权限: bash chmod +x start.sh index.js
  4. 添加 GitHub Token: bash echo "your-github-token" > .github_token
  5. 配置 Claude Desktop:
  6. 编辑配置文件:
    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • Windows: %APPDATA%\Claude\claude_desktop_config.json
  7. 添加配置: json { "mcpServers": { "github": { "command": "/bin/sh", "args": ["-c", "/path/to/github-mcp-server/start.sh"] } } }
  8. 重启 Claude

调试方式

  • 检查 Node.js 和 Git 是否安装正确
  • 确保 GitHub Token 已正确配置
  • 检查 Claude 配置文件是否正确

许可证

该项目遵循 MIT 开源许可条款。