GitHub MCP 服务器使用说明

功能概述

1. 创建新问题

• 函数: createIssue
• 输入参数:
  • owner: 仓库所有者名称（例如：octocat）
  • repo: 仓库名称（例如：hello-world）
  • title: 问题标题（例如：这是一个新问题）
  • body: 问题描述
• 输出: 新创建的问题对象

2. 获取仓库信息

• 函数: getRepositoryInfo
• 输入参数:
  • owner: 仓库所有者名称
  • repo: 仓库名称
• 输出: 包含仓库详细信息的对象，包括成员、分支等信息

3. 获取仓库内容

• 函数: getContents
• 输入参数:
  • owner: 仓库所有者名称
  • repo: 仓库名称
  • path: 文件路径（可选）
• 输出: 指定路径下的文件或目录列表

...（其他功能省略）

搜索语法说明

代码搜索

• language:javascript: 根据编程语言筛选
• repo:owner/name: 在特定仓库中搜索
• path:app/src: 在指定路径下搜索
• extension:js: 根据文件扩展名筛选
• 示例: q: "import express" language:typescript path:src/

问题搜索

• is:issue 或 is:pr: 根据类型筛选
• is:open 或 is:closed: 根据状态筛选
• label:bug: 根据标签筛选
• author:username: 根据作者筛选
• 示例: q: "memory leak" is:issue is:open label:bug

用户搜索

• type:user 或 type:org: 根据账户类型筛选
• followers:>1000: 根据关注者数量筛选
• location:London: 根据位置筛选
• 示例: q: "fullstack developer" location:London followers:>100

配置指南

个人访问令牌

创建 GitHub 个人访问令牌 并确保其具有适当的权限：

• 访问 个人访问令牌（在 GitHub 设置 > 开发者设置中）
• 选择该令牌可以访问的仓库范围（公共、全部或特定仓库）
• 创建一个具有 repo 权限范围的令牌（“对私有仓库进行全面控制”）
  • 如果仅用于公开仓库，可以选择 public_repo 权限范围
• 复制生成的令牌

在 Claude Desktop 上使用

在 claude_desktop_config.json 中添加以下配置：

{
  "githubMCP": {
    "token": "your_personal_access_token_here",
    "baseUrl": "https://api.github.com"
  }
}

使用示例

创建新问题

调用 createIssue 函数：

• 输入参数:
  • owner: octocat
  • repo: hello-world
  • title: 这是一个新问题
  • body: 请帮我解决这个问题。

获取仓库信息

调用 getRepositoryInfo 函数：

• 输入参数:
  • owner: octocat
  • repo: hello-world

文档参考

• GitHub API 文档
• MCP 服务器开发文档

请根据实际需求调整上述配置和函数调用。