Provides comprehensive integration with Gitea API including ~22 intelligent MCP tools for workflow analysis, content generation, and compliance checking, plus 200+ CLI commands for complete CRUD operations on issues, pull requests, repositories, wikis, releases, branches, and CI/CD configuration.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Gitea MCP Toollist open issues in the entai-gitea-mcp repository"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Gitea MCP Tool
Gitea API 的 MCP (Model Context Protocol) 服务器，让 AI 助手能够与 Gitea 进行交互。
v2.0 架构
┌─────────────────────────────────────────────────────────────┐
│ Gitea MCP Tool v2.0 │
├─────────────────────────────────────────────────────────────┤
│ │
│ ┌─────────────────┐ ┌─────────────────────────┐ │
│ │ MCP Server │ │ keactl CLI │ │
│ │ (Lite Mode) │ │ (Full Features) │ │
│ ├─────────────────┤ ├─────────────────────────┤ │
│ │ ~22 智能工具 │ │ 200+ 命令 │ │
│ │ • 智能分析 │ │ • 完整 CRUD 操作 │ │
│ │ • 内容生成 │ │ • Issue/PR/Repo 管理 │ │
│ │ • 工作流管理 │ │ • Wiki/Release/Branch │ │
│ │ • 规范检查 │ │ • CI/CD 配置 │ │
│ └────────┬────────┘ └────────────┬────────────┘ │
│ │ │ │
│ └────────────┬───────────────────┘ │
│ ▼ │
│ ┌─────────────────┐ │
│ │ Gitea API │ │
│ └─────────────────┘ │
└─────────────────────────────────────────────────────────────┘特性
MCP 智能工具 - ~22 个智能分析、内容生成、工作流管理工具
keactl CLI - 200+ 命令，完整 CRUD 操作（Issue/PR/Repo/Wiki/Release）
低 Context 消耗 - MCP Lite 模式优化，减少 90% token 使用
多客户端支持 - Claude Desktop/CLI、OpenCode、Codex、Cline、Cursor
8 个交互式 Prompts - 引导式操作模板
快速安装
# npm 安装（推荐）
npm install -g gitea-mcp-tool
# 或使用安装脚本
curl -fsSL https://gitea.ktyun.cc/Kysion/entai-gitea-mcp/raw/branch/main/install-quick.sh | bash配置
1. 配置 MCP 客户端
Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):
{
"mcpServers": {
"gitea-mcp-tool": {
"command": "gitea-mcp",
"env": {
"GITEA_BASE_URL": "https://your-gitea-server.com",
"GITEA_API_TOKEN": "your_token_here"
}
}
}
}Claude CLI (~/.claude.json):
{
"mcpServers": {
"gitea-mcp-tool": {
"type": "stdio",
"command": "gitea-mcp",
"env": {
"GITEA_BASE_URL": "https://your-gitea-server.com",
"GITEA_API_TOKEN": "your_token_here"
}
}
}
}OpenCode (~/.config/opencode/config.json):
{
"mcpServers": {
"gitea-mcp-tool": {
"type": "stdio",
"command": "gitea-mcp",
"env": {
"GITEA_BASE_URL": "https://your-gitea-server.com",
"GITEA_API_TOKEN": "your_token_here"
}
}
}
}通用 MCP 配置 (.mcp.json 放在项目根目录):
{
"mcpServers": {
"gitea-mcp-tool": {
"type": "stdio",
"command": "gitea-mcp",
"env": {
"GITEA_BASE_URL": "https://gitea.ktyun.cc",
"GITEA_DEFAULT_OWNER": "Kysion",
"GITEA_DEFAULT_REPO": "entai-gitea-mcp"
}
}
}
}在运行前，请在环境变量中提供
GITEA_API_TOKEN，否则服务器会因缺少认证而启动失败。
2. 获取 API Token
登录 Gitea → 设置 → 应用
生成新令牌
复制到配置文件
3. 重启客户端
MCP + CLI 混合使用
v2.0 采用 MCP 智能工具 + keactl CLI 混合模式：
操作类型 | 推荐方式 | 示例 |
智能分析 | MCP 工具 |
|
内容生成 | MCP 工具 |
|
CRUD 操作 | keactl CLI |
|
批量操作 | keactl CLI |
|
MCP 智能工具示例
// 智能标签推断
gitea_workflow_infer_labels({ issue_number: 42, auto_apply: true })
// 规范检查
gitea_compliance_check_all()
// 生成工作流报告
gitea_workflow_generate_report({ time_range: "week" })
// AI 辅助创建 Issue
gitea_issue_create({ title: "Bug: 登录失败", body: "详细描述..." })keactl CLI 示例
# 仓库操作
keactl repo list
keactl repo get
# Issue 操作
keactl issue list --state open
keactl issue get 42
keactl issue create --title "Bug" --body "描述"
keactl issue close 42
# PR 操作
keactl pr list
keactl pr create --title "feat: 新功能" --head feature --base main
keactl pr merge 1
# Wiki 操作
keactl wiki list
keactl wiki get "Home"
keactl wiki create --title "Guide" --content "# 指南"
# Release 操作
keactl release list
keactl release create --tag v1.0.0
# Branch 操作
keactl branch list
keactl branch create feature/new
# CI/CD 配置
keactl cicd init
keactl cicd status
keactl cicd validateMCP 工具清单
基础设施 (5 个)
工具 | 说明 |
| 初始化项目配置 |
| 升级 MCP 工具 |
| 获取当前上下文 |
| 设置默认上下文 |
| 获取当前用户 |
智能内容生成 (2 个)
工具 | 说明 |
| AI 辅助创建 Issue |
| AI 辅助创建 PR |
工作流智能分析 (10 个)
工具 | 说明 |
| 初始化工作流配置 |
| 加载工作流配置 |
| 同步标签系统 |
| 同步项目看板 |
| 检查 Issue 工作流 |
| 智能标签推断 |
| 检测阻塞 Issue |
| 优先级自动升级 |
| 状态双向同步 |
| 生成工作流报告 |
规范检查 (5 个)
工具 | 说明 |
| 初始化规范配置 |
| 检查分支命名 |
| 检查提交信息 |
| 检查 PR 规范 |
| 全面规范检查 |
文档
本地文档
多客户端配置指南 - Claude Desktop/CLI、OpenCode、Cline、Cursor、Continue 配置
Wiki 文档
详细文档请参阅 Wiki:
版本
当前版本: v2.0.0-beta | MCP 工具数: ~22 | CLI 命令数: 200+
许可证
MIT License