🚀 Gitee开源工具

Gitee 是一个基于模型上下文协议（Model Context Protocol, MCP）的开源工具，它旨在简化与 Gitee 平台的交互操作。通过提供多种功能模块，能帮助开发者高效管理代码仓库、处理 pull request 和 issue 等任务。

🚀 快速开始

Gitee 工具可助力开发者高效管理代码仓库、处理 pull request 和 issue 等任务。你可按以下步骤安装使用：

📦 安装指南

安装步骤

1. 克隆项目仓库：

git clone https://gitee.com/yourusername/mcp.git
cd mcp

2. 安装依赖项：

go mod tidy

3. 启动服务：

go run main.go --port=8080

💻 使用示例

基础用法

配置示例

环境变量配置

export GITEE_TOKEN="your_token"
export GITEE_API_BASE="https://gitee.com/api/v3"

命令行选项

--token 明文 API 令牌  
--port 指定服务监听的端口 [默认: "8080"]  
--mode {development|production} 设置运行模式 [可选值: development, production]  

高级用法

工具集管理

管理方式

1. 白名单模式：

   • 使用 --enabled-tools 参数或 ENABLED_TOOLS 环境变量指定允许的工具，其余工具将被禁用。
   • 示例：--enabled-tools="list_repos,get_file"

2. 黑名单模式：

   • 使用 --disabled-tools 参数或 DISABLED_TOOLS 环境变量指定禁止使用的工具，其余工具默认启用。
   • 示例：--disabled-tools="list_repos,get_file"

注意事项

⚠️ 重要提示

• 若同时配置了 enabled-tools 和 disabled-tools，白名单优先级更高。
• 工具名称区分大小写。

📚 详细文档

可用工具

该服务提供了多种与 Gitee 平台交互的功能模块：

贡献指南

我们欢迎社区贡献！如果你希望参与项目，请遵循以下步骤：

1. Fork 该项目仓库。
2. 在你的Fork中创建一个新的分支用于功能开发或问题修复。
3. 提交代码更改并推送至远程仓库。
4. 创建 Pull Request 到原项目仓库。

💡 使用建议

• 遵循 Go 语言的编码规范和命名习惯。
• 提供完整的单元测试用例。
• 确保代码提交信息清晰易懂。

📄 许可证

本项目遵循 MIT 协议，具体条款请参考 LICENSE 文件。