Show How to Use MCP

这个仓库展示了如何使用 GitHub MCP (Model Context Protocol) 服务来自动化管理 GitHub 仓库和进行各种 GitHub 操作。

MCP 是什么？

MCP (Model Context Protocol) 是一个强大的协议，它允许 AI 模型（如 Claude）通过编程方式与 GitHub API 进行交互。通过 MCP，我们可以：

• 创建和管理仓库
• 操作文件（创建、读取、更新、删除）
• 管理 Issues 和 Pull Requests
• 处理分支和提交
• 以及更多 GitHub 相关操作

主要功能示例

1. 仓库管理

# 创建仓库
mcp_github_create_repository(name="my-repo", description="My new repository")

# 分叉仓库
mcp_github_fork_repository(owner="original-owner", repo="original-repo")

2. 文件操作

# 创建或更新文件
mcp_github_create_or_update_file(
    owner="username",
    repo="repo-name",
    path="path/to/file",
    message="commit message",
    content="file content"
)

3. Issue 和 PR 管理

# 创建 Issue
mcp_github_create_issue(
    owner="username",
    repo="repo-name",
    title="Issue title",
    body="Issue description"
)

# 创建 Pull Request
mcp_github_create_pull_request(
    owner="username",
    repo="repo-name",
    title="PR title",
    head="feature-branch",
    base="main"
)

使用步骤

1. 设置 GitHub Personal Access Token

export GITHUB_PERSONAL_ACCESS_TOKEN='your-token-here'

2. 确保有适当的权限范围（Scopes）：

   • repo - 完整的仓库访问权限
   • workflow - 工作流权限（如果需要）
   • admin:org - 组织管理（如果需要）

3. 开始使用 MCP 功能进行自动化操作

最佳实践

1. 始终使用有意义的提交信息
2. 遵循 GitHub 的速率限制
3. 妥善保管你的访问令牌
4. 在进行重要操作前先测试
5. 使用适当的错误处理机制

注意事项

• 请确保不要在代码中硬编码你的访问令牌
• 在公开仓库中要特别注意敏感信息
• 建议在进行批量操作时添加适当的延迟
• 定期检查和更新访问令牌

贡献

欢迎提交 Issue 和 Pull Request 来改进这个示例仓库！

许可证

MIT License