🚀 Forgejo MCP 服务器
Forgejo MCP 服务器 是一款集成插件，它能将 Forgejo 与模型上下文协议（MCP）系统相连接。借助该插件，你可以通过兼容 MCP 的聊天界面执行命令和管理仓库，极大地提升了操作的便捷性。
🚀 快速开始
🚧 安装
📥 下载官方二进制文件
你可以从 这里 下载官方二进制文件。
🔧 从源码构建
你可以通过 Git 克隆仓库来下载源代码：
git clone https://forgejo.org/forgejo/forgejo-mcp.git
在构建之前，请确保安装了以下工具：
- make
- Golang（推荐使用 Go 1.24 或更高版本）
然后运行：
make build
📁 添加到 PATH
构建完成后，将二进制文件 forgejo-mcp 复制到系统 PATH 包含的目录中。例如：
cp forgejo-mcp /usr/local/bin/
🚀 使用方法
此示例适用于 Cursor，你也可以在 VSCode 中使用插件。要配置 Forgejo 的 MCP 服务器，请将以下内容添加到你的 MCP 配置文件中：
💻 基础用法
- stdio 模式
{
"mcpServers": {
"forgejo": {
"command": "forgejo-mcp",
"args": [
"-t", "stdio",
"--host", "https://forgejo.org"
// "--token", "<你的个人访问令牌>"
],
"env": {
// "GITEA_HOST": "https://forgejo.org",
"GITEA_ACCESS_TOKEN": "<你的个人访问令牌>"
}
}
}
}
- sse 模式
{
"mcpServers": {
"forgejo": {
"url": "http://localhost:8080/sse"
}
}
}
⚠️ 重要提示 你可以通过命令行参数或环境变量提供你的 Forgejo 主机和访问令牌，且命令行参数具有最高优先级。
配置完成后，尝试在 MCP 兼容的聊天框中输入以下内容：
列出我所有的仓库
✅ 可用工具
Forgejo MCP 服务器支持以下工具：
| 工具 | 作用域 | 描述 |
|---|---|---|
| get_my_user_info | User | 获取已认证用户的详细信息 |
| create_repo | Repository | 创建新仓库 |
| fork_repo | Repository | 叉取一个仓库 |
| list_my_repos | Repository | 列出所有属于当前用户的所有仓库 |
| create_branch | Branch | 创建新的分支 |
| delete_branch | Branch | 删除一个分支 |
| list_branches | Branch | 列出仓库中的所有分支 |
| list_repo_commits | Commit | 列出仓库中所有的提交 |
| get_file_content | File | 获取文件的内容和元数据 |
| create_file | File | 创建新的文件 |
| update_file | File | 更新现有的文件 |
| delete_file | File | 删除一个文件 |
| get_issue_by_index | Issue | 根据索引获取问题 |
| list_repo_issues | Issue | 列出仓库中所有的问题 |
| create_issue | Issue | 创建新的问题 |
| create_issue_comment | Issue | 在一个问题上创建评论 |
| get_pull_request_by_index | Pull Request | 根据索引获取拉取请求 |
| list_repo_pull_requests | Pull Request | 列出仓库中所有的拉取请求 |
| create_pull_request | Pull Request | 创建新的拉取请求 |
🚈 调试
要启用调试模式，请在运行 forgejo-mcp 时添加 -d 或 --debug 标志：
forgejo-mcp -d
这将使服务器输出详细的调试信息，帮助你排查问题。