Which integrations are available for this server?

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.

How do I use Gitea MCP Tool?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Gitea MCP Tool list 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

by SupenBysz

Overview Schema Related Servers Score Discussions

TypeScript

Remote

Gitea MCP Tool

Gitea API 的 MCP (Model Context Protocol) 服务器，让 AI 助手能够与 Gitea 进行交互。

npm version License: MIT GitHub

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 工具	`gitea_workflow_infer_labels`、`gitea_compliance_check_all`
内容生成	MCP 工具	`gitea_issue_create`、`gitea_pr_create`
CRUD 操作	keactl CLI	`keactl issue list`、`keactl repo get`
批量操作	keactl CLI	`keactl issue close 1,2,3`

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 validate

MCP 工具清单

基础设施 (5 个)

工具	说明
`gitea_init`	初始化项目配置
`gitea_mcp_upgrade`	升级 MCP 工具
`gitea_context_get`	获取当前上下文
`gitea_context_set`	设置默认上下文
`gitea_user_current`	获取当前用户

智能内容生成 (2 个)

工具	说明
`gitea_issue_create`	AI 辅助创建 Issue
`gitea_pr_create`	AI 辅助创建 PR

工作流智能分析 (10 个)

工具	说明
`gitea_workflow_init`	初始化工作流配置
`gitea_workflow_load_config`	加载工作流配置
`gitea_workflow_sync_labels`	同步标签系统
`gitea_workflow_sync_board`	同步项目看板
`gitea_workflow_check_issues`	检查 Issue 工作流
`gitea_workflow_infer_labels`	智能标签推断
`gitea_workflow_check_blocked`	检测阻塞 Issue
`gitea_workflow_escalate_priority`	优先级自动升级
`gitea_workflow_sync_status`	状态双向同步
`gitea_workflow_generate_report`	生成工作流报告

规范检查 (5 个)

工具	说明
`gitea_compliance_init`	初始化规范配置
`gitea_compliance_check_branch`	检查分支命名
`gitea_compliance_check_commit`	检查提交信息
`gitea_compliance_check_pr`	检查 PR 规范
`gitea_compliance_check_all`	全面规范检查

文档

本地文档

多客户端配置指南 - Claude Desktop/CLI、OpenCode、Cline、Cursor、Continue 配置
MCP + CLI 混合使用指南
v1.x → v2.0 迁移指南
更新日志

Wiki 文档

详细文档请参阅 Wiki:

版本

当前版本: v2.0.0-beta | MCP 工具数: ~22 | CLI 命令数: 200+

许可证

MIT License

问题反馈

提交 Issue

Install Server

security – no known vulnerabilities

license - not found

quality - not tested

How are these scores calculated?

Resources

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

View all tools

Appeared in Searches

操作 Gitee 仓库的工具

Latest Blog Posts

Tool Definition Quality Score (TDQS)
By punkpeye on April 3, 2026.
mcp
The Hackers Who Tracked My Sleep Cycle
By punkpeye on March 26, 2026.
security
Open Source Has a Bot Problem
By punkpeye on March 19, 2026.
open source

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/SupenBysz/gitea-mcp-tool'

If you have feedback or need assistance with the MCP directory API, please join our Discord server