gitea-mcp: 初次落地 Gitea MCP Server (.NET 10, V1 only-read)
把 Gitea (git.zhengchentao.win) 通过 MCP 暴露给 Claude.ai：列 repo、读代码、看 commits / issues / PR / orgs / packages / actions。 设计文档见 vault Coding/gitea-mcp/gitea-mcp 设计.md。 代码模板复用 obsidian-mcp（.NET 10 + ModelContextProtocol SDK + JwtBearer）。 19 个只读 Tool（全部 scope=read:gitea）： Repo / 文件： - list_repos / read_repo - list_tree（max_entries=500 防爆） - read_file（max_bytes=1MB，超出 truncated=true） - search_code（走 /repos/search-code，indexer 未启用时返回结构化错误说明） 分支 / 提交： - list_branches / list_commits / read_commit（diff 文件数限 50） Issue / PR： - list_issues / read_issue（含评论） - list_pulls / read_pull（含评论 + 改动文件列表） Org / Package（用户额外授权 read:organization + read:package）： - list_orgs / read_org - list_packages / read_package Gitea Actions（运维友好）： - list_workflow_runs / read_run_log 技术栈： - .NET 10 + ModelContextProtocol SDK 1.0 - HttpClientFactory + Microsoft.Extensions.Http.Resilience（指数 backoff，5xx/429/网络错误重试） - JwtBearer (HS256, Current+Previous fallback, MapInboundClaims=false) - aud=gitea, scope=read:gitea, iss=https://auth.zhengchentao.win Gitea API client： - Authorization: token <PAT> (admin PAT，仅 read scope) - BaseUrl=https://git.zhengchentao.win - 错误映射：401/403 → UnauthorizedAccessException，404 → KeyNotFoundException，5xx → InvalidOperationException - RepoBlacklist 黑名单（owner/repo 精确匹配，默认空） 部署： - Dockerfile multi-stage，COPY --chown，non-root user - .gitea/workflows/build-image.yml：build + deploy 双 job，buildkit v0.13.2 - 容器内 :8080，宿主端口 9092 - 子域名 git-mcp.zhengchentao.win（区别于 Gitea 本体 git.zhengchentao.win） 测试：6/6 单测过（GiteaRepoFilter 黑名单匹配） Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
This commit is contained in:
@@ -0,0 +1,295 @@
|
||||
using GiteaMcp.Config;
|
||||
using GiteaMcp.Services.Models;
|
||||
using Microsoft.Extensions.Options;
|
||||
using System.Net;
|
||||
using System.Net.Http.Headers;
|
||||
using System.Text.Json;
|
||||
|
||||
namespace GiteaMcp.Services;
|
||||
|
||||
/// <summary>
|
||||
/// Gitea REST API 封装。
|
||||
/// 使用 HttpClientFactory 注入（named client "gitea"），统一带 admin PAT header。
|
||||
/// 所有公开方法在 Gitea 返回错误时抛出结构化异常，不会静默返回空值。
|
||||
/// </summary>
|
||||
public class GiteaApiClient
|
||||
{
|
||||
private readonly HttpClient _http;
|
||||
private readonly GiteaOptions _opts;
|
||||
private readonly ILogger<GiteaApiClient> _logger;
|
||||
|
||||
private static readonly JsonSerializerOptions JsonOpts = new()
|
||||
{
|
||||
PropertyNameCaseInsensitive = true,
|
||||
};
|
||||
|
||||
public GiteaApiClient(
|
||||
IHttpClientFactory factory,
|
||||
IOptions<GiteaOptions> opts,
|
||||
ILogger<GiteaApiClient> logger)
|
||||
{
|
||||
_opts = opts.Value;
|
||||
_logger = logger;
|
||||
_http = factory.CreateClient("gitea");
|
||||
}
|
||||
|
||||
// ───────────── Repos ─────────────
|
||||
|
||||
/// <summary>
|
||||
/// 搜索所有仓库。owner 为 null 时搜索全部（含 org）。
|
||||
/// visibility: "public" | "private" | "all"
|
||||
/// </summary>
|
||||
public async Task<List<GiteaRepo>> SearchReposAsync(
|
||||
string? owner, string visibility, int limit, CancellationToken ct = default)
|
||||
{
|
||||
// Gitea /repos/search 支持 limit / private / uid / topic 等参数
|
||||
var url = $"/api/v1/repos/search?limit={limit}&include_desc=true";
|
||||
|
||||
if (!string.IsNullOrWhiteSpace(owner))
|
||||
url += $"&q={Uri.EscapeDataString(owner)}";
|
||||
|
||||
if (visibility == "private")
|
||||
url += "&private=true";
|
||||
else if (visibility == "public")
|
||||
url += "&private=false";
|
||||
// "all" 不加 private 参数，admin PAT 能看到所有
|
||||
|
||||
var result = await GetAsync<GiteaRepoSearchResult>(url, ct);
|
||||
return result.Data;
|
||||
}
|
||||
|
||||
/// <summary>读取单个仓库元数据</summary>
|
||||
public Task<GiteaRepo> GetRepoAsync(string owner, string repo, CancellationToken ct = default)
|
||||
=> GetAsync<GiteaRepo>($"/api/v1/repos/{owner}/{repo}", ct);
|
||||
|
||||
// ───────────── Tree & File ─────────────
|
||||
|
||||
/// <summary>获取仓库文件树</summary>
|
||||
public async Task<GiteaTree> GetTreeAsync(
|
||||
string owner, string repo, string @ref, bool recursive, CancellationToken ct = default)
|
||||
{
|
||||
var url = $"/api/v1/repos/{owner}/{repo}/git/trees/{Uri.EscapeDataString(@ref)}";
|
||||
if (recursive) url += "?recursive=true";
|
||||
return await GetAsync<GiteaTree>(url, ct);
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// 读取文件原始内容（字节），支持 maxBytes 截断。
|
||||
/// 返回 (content, truncated)。
|
||||
/// </summary>
|
||||
public async Task<(string Content, bool Truncated)> GetRawFileAsync(
|
||||
string owner, string repo, string @ref, string path, int maxBytes, CancellationToken ct = default)
|
||||
{
|
||||
var url = $"/api/v1/repos/{owner}/{repo}/raw/{Uri.EscapeDataString(@ref)}/{path.TrimStart('/')}";
|
||||
var response = await SendAsync(url, ct);
|
||||
|
||||
// 读最多 maxBytes + 1 字节，用来判断是否截断
|
||||
using var stream = await response.Content.ReadAsStreamAsync(ct);
|
||||
var buffer = new byte[maxBytes + 1];
|
||||
var bytesRead = await stream.ReadAsync(buffer.AsMemory(), ct);
|
||||
|
||||
bool truncated = bytesRead > maxBytes;
|
||||
var actual = truncated ? buffer[..maxBytes] : buffer[..bytesRead];
|
||||
return (System.Text.Encoding.UTF8.GetString(actual), truncated);
|
||||
}
|
||||
|
||||
// ───────────── Branches & Commits ─────────────
|
||||
|
||||
public Task<List<GiteaBranch>> GetBranchesAsync(
|
||||
string owner, string repo, CancellationToken ct = default)
|
||||
=> GetAsync<List<GiteaBranch>>($"/api/v1/repos/{owner}/{repo}/branches", ct);
|
||||
|
||||
public async Task<List<GiteaCommitSummary>> GetCommitsAsync(
|
||||
string owner, string repo, string? @ref, string? since, int limit, CancellationToken ct = default)
|
||||
{
|
||||
var url = $"/api/v1/repos/{owner}/{repo}/commits?limit={limit}&stat=false&files=false&verification=false";
|
||||
if (!string.IsNullOrWhiteSpace(@ref)) url += $"&sha={Uri.EscapeDataString(@ref)}";
|
||||
if (!string.IsNullOrWhiteSpace(since)) url += $"&since={Uri.EscapeDataString(since)}";
|
||||
return await GetAsync<List<GiteaCommitSummary>>(url, ct);
|
||||
}
|
||||
|
||||
public Task<GiteaCommitFull> GetCommitAsync(
|
||||
string owner, string repo, string sha, CancellationToken ct = default)
|
||||
=> GetAsync<GiteaCommitFull>($"/api/v1/repos/{owner}/{repo}/git/commits/{sha}", ct);
|
||||
|
||||
// ───────────── Issues ─────────────
|
||||
|
||||
public Task<List<GiteaIssue>> GetIssuesAsync(
|
||||
string owner, string repo, string state, int limit, CancellationToken ct = default)
|
||||
=> GetAsync<List<GiteaIssue>>(
|
||||
$"/api/v1/repos/{owner}/{repo}/issues?type=issues&state={state}&limit={limit}", ct);
|
||||
|
||||
public Task<GiteaIssue> GetIssueAsync(
|
||||
string owner, string repo, int number, CancellationToken ct = default)
|
||||
=> GetAsync<GiteaIssue>($"/api/v1/repos/{owner}/{repo}/issues/{number}", ct);
|
||||
|
||||
public Task<List<GiteaComment>> GetIssueCommentsAsync(
|
||||
string owner, string repo, int number, CancellationToken ct = default)
|
||||
=> GetAsync<List<GiteaComment>>($"/api/v1/repos/{owner}/{repo}/issues/{number}/comments", ct);
|
||||
|
||||
// ───────────── Pull Requests ─────────────
|
||||
|
||||
public Task<List<GiteaPullRequest>> GetPullsAsync(
|
||||
string owner, string repo, string state, int limit, CancellationToken ct = default)
|
||||
=> GetAsync<List<GiteaPullRequest>>(
|
||||
$"/api/v1/repos/{owner}/{repo}/pulls?state={state}&limit={limit}", ct);
|
||||
|
||||
public Task<GiteaPullRequest> GetPullAsync(
|
||||
string owner, string repo, int number, CancellationToken ct = default)
|
||||
=> GetAsync<GiteaPullRequest>($"/api/v1/repos/{owner}/{repo}/pulls/{number}", ct);
|
||||
|
||||
public Task<List<GiteaComment>> GetPullCommentsAsync(
|
||||
string owner, string repo, int number, CancellationToken ct = default)
|
||||
=> GetAsync<List<GiteaComment>>($"/api/v1/repos/{owner}/{repo}/issues/{number}/comments", ct);
|
||||
|
||||
public Task<List<GiteaPrFile>> GetPullFilesAsync(
|
||||
string owner, string repo, int number, CancellationToken ct = default)
|
||||
=> GetAsync<List<GiteaPrFile>>($"/api/v1/repos/{owner}/{repo}/pulls/{number}/files", ct);
|
||||
|
||||
// ───────────── Orgs ─────────────
|
||||
|
||||
/// <summary>
|
||||
/// 列出所有组织。优先 /orgs/search（任意 read PAT 即可）；
|
||||
/// 仅当带 admin scope 的 PAT 才能访问 /admin/orgs。本服务的 PAT 设计为只读，
|
||||
/// 因此不走 /admin/* 端点。/orgs/search 不传 q 时返回所有可见 org。
|
||||
/// </summary>
|
||||
public async Task<List<GiteaOrg>> GetOrgsAsync(int limit, CancellationToken ct = default)
|
||||
{
|
||||
// /orgs/search 返回 { ok, data: [...] }
|
||||
var resp = await GetAsync<GiteaOrgSearchResult>($"/api/v1/orgs/search?limit={limit}", ct);
|
||||
return resp.Data;
|
||||
}
|
||||
|
||||
public Task<GiteaOrg> GetOrgAsync(string name, CancellationToken ct = default)
|
||||
=> GetAsync<GiteaOrg>($"/api/v1/orgs/{name}", ct);
|
||||
|
||||
// ───────────── Packages ─────────────
|
||||
|
||||
public Task<List<GiteaPackage>> GetPackagesAsync(
|
||||
string owner, string? type, int limit, CancellationToken ct = default)
|
||||
{
|
||||
var url = $"/api/v1/packages/{owner}?limit={limit}";
|
||||
if (!string.IsNullOrWhiteSpace(type)) url += $"&type={type}";
|
||||
return GetAsync<List<GiteaPackage>>(url, ct);
|
||||
}
|
||||
|
||||
public Task<GiteaPackage> GetPackageAsync(
|
||||
string owner, string type, string name, string version, CancellationToken ct = default)
|
||||
=> GetAsync<GiteaPackage>($"/api/v1/packages/{owner}/{type}/{Uri.EscapeDataString(name)}/{Uri.EscapeDataString(version)}", ct);
|
||||
|
||||
// ───────────── Actions ─────────────
|
||||
|
||||
public async Task<GiteaWorkflowRunList> GetWorkflowRunsAsync(
|
||||
string owner, string repo, string? branch, string? status, int limit, CancellationToken ct = default)
|
||||
{
|
||||
var url = $"/api/v1/repos/{owner}/{repo}/actions/runs?limit={limit}";
|
||||
if (!string.IsNullOrWhiteSpace(branch)) url += $"&branch={Uri.EscapeDataString(branch)}";
|
||||
if (!string.IsNullOrWhiteSpace(status)) url += $"&status={status}";
|
||||
return await GetAsync<GiteaWorkflowRunList>(url, ct);
|
||||
}
|
||||
|
||||
public Task<GiteaWorkflowRun> GetWorkflowRunAsync(
|
||||
string owner, string repo, long runId, CancellationToken ct = default)
|
||||
=> GetAsync<GiteaWorkflowRun>($"/api/v1/repos/{owner}/{repo}/actions/runs/{runId}", ct);
|
||||
|
||||
public Task<GiteaWorkflowJobList> GetRunJobsAsync(
|
||||
string owner, string repo, long runId, CancellationToken ct = default)
|
||||
=> GetAsync<GiteaWorkflowJobList>($"/api/v1/repos/{owner}/{repo}/actions/runs/{runId}/jobs", ct);
|
||||
|
||||
/// <summary>
|
||||
/// 获取 run/job 日志。Gitea Actions log API 返回 ZIP 或纯文本，
|
||||
/// 这里最多读 maxBytes（1MB）防爆内存。
|
||||
/// </summary>
|
||||
public async Task<string> GetRunLogAsync(
|
||||
string owner, string repo, long runId, long? jobId, int maxBytes = 1024 * 1024,
|
||||
CancellationToken ct = default)
|
||||
{
|
||||
var url = jobId.HasValue
|
||||
? $"/api/v1/repos/{owner}/{repo}/actions/runs/{runId}/jobs/{jobId}/logs"
|
||||
: $"/api/v1/repos/{owner}/{repo}/actions/runs/{runId}/logs";
|
||||
|
||||
try
|
||||
{
|
||||
var response = await SendAsync(url, ct);
|
||||
using var stream = await response.Content.ReadAsStreamAsync(ct);
|
||||
var buffer = new byte[maxBytes];
|
||||
var bytesRead = await stream.ReadAsync(buffer.AsMemory(), ct);
|
||||
var text = System.Text.Encoding.UTF8.GetString(buffer, 0, bytesRead);
|
||||
return bytesRead == maxBytes
|
||||
? text + "\n[...log truncated at 1MB...]"
|
||||
: text;
|
||||
}
|
||||
catch (KeyNotFoundException)
|
||||
{
|
||||
// Actions log 可能还未生成（run 刚开始）
|
||||
return "[Log not yet available]";
|
||||
}
|
||||
}
|
||||
|
||||
// ───────────── Code search ─────────────
|
||||
|
||||
/// <summary>
|
||||
/// 代码搜索。需要 Gitea 启用 code indexer（app.ini [indexer] REPO_INDEXER_ENABLED = true）。
|
||||
/// indexer 未启用时 Gitea 返回 404，调用方应降级并告知 Claude（不要 swallow 到空数组）。
|
||||
/// </summary>
|
||||
/// <remarks>
|
||||
/// Gitea API：
|
||||
/// GET /api/v1/repos/search-code?q=&owner=&repo=&limit=
|
||||
/// 未启用 indexer 时端点返回 404，由 EnsureSuccessAsync 抛 KeyNotFoundException，
|
||||
/// 上游 SearchTools 捕获此异常返回结构化 indexer-disabled 提示。
|
||||
/// </remarks>
|
||||
public async Task<GiteaCodeSearchResponse> SearchCodeAsync(
|
||||
string query, string? owner, string? repo, int limit, CancellationToken ct = default)
|
||||
{
|
||||
var url = $"/api/v1/repos/search-code?q={Uri.EscapeDataString(query)}&limit={limit}";
|
||||
if (!string.IsNullOrWhiteSpace(owner)) url += $"&owner={Uri.EscapeDataString(owner)}";
|
||||
if (!string.IsNullOrWhiteSpace(repo)) url += $"&repo={Uri.EscapeDataString(repo)}";
|
||||
|
||||
return await GetAsync<GiteaCodeSearchResponse>(url, ct);
|
||||
}
|
||||
|
||||
// ───────────── Private helpers ─────────────
|
||||
|
||||
private async Task<T> GetAsync<T>(string relativeUrl, CancellationToken ct)
|
||||
{
|
||||
var response = await SendAsync(relativeUrl, ct);
|
||||
var json = await response.Content.ReadAsStringAsync(ct);
|
||||
return JsonSerializer.Deserialize<T>(json, JsonOpts)
|
||||
?? throw new InvalidOperationException($"Empty response from Gitea: {relativeUrl}");
|
||||
}
|
||||
|
||||
private async Task<HttpResponseMessage> SendAsync(string relativeUrl, CancellationToken ct)
|
||||
{
|
||||
_logger.LogDebug("Gitea GET {Url}", relativeUrl);
|
||||
var response = await _http.GetAsync(relativeUrl, ct);
|
||||
await EnsureSuccessAsync(response, relativeUrl);
|
||||
return response;
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// 把 Gitea HTTP 错误码转换为语义清晰的异常。
|
||||
/// 绝不 swallow 异常——Claude 需要看到真实错误原因。
|
||||
/// </summary>
|
||||
private static async Task EnsureSuccessAsync(HttpResponseMessage response, string url)
|
||||
{
|
||||
if (response.IsSuccessStatusCode) return;
|
||||
|
||||
var body = string.Empty;
|
||||
try { body = await response.Content.ReadAsStringAsync(); } catch { }
|
||||
|
||||
throw response.StatusCode switch
|
||||
{
|
||||
HttpStatusCode.Unauthorized or HttpStatusCode.Forbidden
|
||||
=> new UnauthorizedAccessException(
|
||||
$"Gitea PAT invalid or insufficient scope. URL={url}, Status={response.StatusCode}, Body={body}"),
|
||||
HttpStatusCode.NotFound
|
||||
=> new KeyNotFoundException(
|
||||
$"Repo/Resource not found: {url}. Body={body}"),
|
||||
>= HttpStatusCode.InternalServerError
|
||||
=> new InvalidOperationException(
|
||||
$"Gitea backend error ({(int)response.StatusCode}). URL={url}, Body={body}"),
|
||||
_ => new HttpRequestException(
|
||||
$"Gitea returned {(int)response.StatusCode}. URL={url}, Body={body}")
|
||||
};
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,45 @@
|
||||
using GiteaMcp.Config;
|
||||
using GiteaMcp.Services.Models;
|
||||
using Microsoft.Extensions.Options;
|
||||
|
||||
namespace GiteaMcp.Services;
|
||||
|
||||
/// <summary>
|
||||
/// 仓库黑名单过滤器。
|
||||
/// 配置项 Gitea:RepoBlacklist 为逗号分隔的 "owner/repo" 列表，默认空（全开放）。
|
||||
/// 所有返回仓库列表的 Tool 都经过此过滤器，防止意外暴露不希望 Claude 看到的仓库。
|
||||
/// </summary>
|
||||
public class GiteaRepoFilter
|
||||
{
|
||||
private readonly HashSet<string> _blacklist;
|
||||
|
||||
public GiteaRepoFilter(IOptions<GiteaOptions> opts)
|
||||
{
|
||||
var raw = opts.Value.RepoBlacklist ?? string.Empty;
|
||||
|
||||
// 解析 "owner/repo,owner2/repo2" 格式，大小写不敏感
|
||||
_blacklist = raw
|
||||
.Split(',', StringSplitOptions.RemoveEmptyEntries | StringSplitOptions.TrimEntries)
|
||||
.Select(s => s.ToLowerInvariant())
|
||||
.ToHashSet();
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// 判断单个仓库是否在黑名单内。
|
||||
/// full_name 格式为 "owner/repo"（Gitea API 返回的 full_name 字段）。
|
||||
/// </summary>
|
||||
public bool IsBlocked(string fullName)
|
||||
=> _blacklist.Contains(fullName.ToLowerInvariant());
|
||||
|
||||
/// <summary>
|
||||
/// 从列表中过滤掉黑名单仓库，返回新列表（不修改原列表）。
|
||||
/// </summary>
|
||||
public List<GiteaRepo> Filter(List<GiteaRepo> repos)
|
||||
{
|
||||
if (_blacklist.Count == 0) return repos;
|
||||
return repos.Where(r => !IsBlocked(r.FullName)).ToList();
|
||||
}
|
||||
|
||||
/// <summary>当前黑名单项数，用于日志 / 测试断言</summary>
|
||||
public int BlacklistCount => _blacklist.Count;
|
||||
}
|
||||
@@ -0,0 +1,98 @@
|
||||
using System.Text.Json.Serialization;
|
||||
|
||||
namespace GiteaMcp.Services.Models;
|
||||
|
||||
/// <summary>Gitea commit 摘要（list_commits 使用）</summary>
|
||||
public class GiteaCommitSummary
|
||||
{
|
||||
[JsonPropertyName("sha")]
|
||||
public string Sha { get; set; } = string.Empty;
|
||||
|
||||
[JsonPropertyName("created")]
|
||||
public DateTimeOffset Created { get; set; }
|
||||
|
||||
[JsonPropertyName("commit")]
|
||||
public GiteaCommitDetail? Commit { get; set; }
|
||||
|
||||
[JsonPropertyName("author")]
|
||||
public GiteaUser? Author { get; set; }
|
||||
}
|
||||
|
||||
public class GiteaCommitDetail
|
||||
{
|
||||
[JsonPropertyName("message")]
|
||||
public string Message { get; set; } = string.Empty;
|
||||
|
||||
[JsonPropertyName("author")]
|
||||
public GiteaCommitSignature? Author { get; set; }
|
||||
|
||||
[JsonPropertyName("committer")]
|
||||
public GiteaCommitSignature? Committer { get; set; }
|
||||
}
|
||||
|
||||
public class GiteaCommitSignature
|
||||
{
|
||||
[JsonPropertyName("name")]
|
||||
public string Name { get; set; } = string.Empty;
|
||||
|
||||
[JsonPropertyName("email")]
|
||||
public string Email { get; set; } = string.Empty;
|
||||
|
||||
[JsonPropertyName("date")]
|
||||
public DateTimeOffset Date { get; set; }
|
||||
}
|
||||
|
||||
/// <summary>read_commit 使用的完整 commit（含 diff 文件列表）</summary>
|
||||
public class GiteaCommitFull
|
||||
{
|
||||
[JsonPropertyName("sha")]
|
||||
public string Sha { get; set; } = string.Empty;
|
||||
|
||||
[JsonPropertyName("created")]
|
||||
public DateTimeOffset Created { get; set; }
|
||||
|
||||
[JsonPropertyName("commit")]
|
||||
public GiteaCommitDetail? Commit { get; set; }
|
||||
|
||||
[JsonPropertyName("author")]
|
||||
public GiteaUser? Author { get; set; }
|
||||
|
||||
[JsonPropertyName("files")]
|
||||
public List<GiteaCommitFile>? Files { get; set; }
|
||||
|
||||
[JsonPropertyName("stats")]
|
||||
public GiteaCommitStats? Stats { get; set; }
|
||||
}
|
||||
|
||||
public class GiteaCommitFile
|
||||
{
|
||||
[JsonPropertyName("filename")]
|
||||
public string Filename { get; set; } = string.Empty;
|
||||
|
||||
[JsonPropertyName("status")]
|
||||
public string Status { get; set; } = string.Empty;
|
||||
|
||||
[JsonPropertyName("additions")]
|
||||
public int Additions { get; set; }
|
||||
|
||||
[JsonPropertyName("deletions")]
|
||||
public int Deletions { get; set; }
|
||||
|
||||
[JsonPropertyName("changes")]
|
||||
public int Changes { get; set; }
|
||||
|
||||
[JsonPropertyName("patch")]
|
||||
public string? Patch { get; set; }
|
||||
}
|
||||
|
||||
public class GiteaCommitStats
|
||||
{
|
||||
[JsonPropertyName("total")]
|
||||
public int Total { get; set; }
|
||||
|
||||
[JsonPropertyName("additions")]
|
||||
public int Additions { get; set; }
|
||||
|
||||
[JsonPropertyName("deletions")]
|
||||
public int Deletions { get; set; }
|
||||
}
|
||||
@@ -0,0 +1,69 @@
|
||||
using System.Text.Json.Serialization;
|
||||
|
||||
namespace GiteaMcp.Services.Models;
|
||||
|
||||
public class GiteaIssue
|
||||
{
|
||||
[JsonPropertyName("number")]
|
||||
public int Number { get; set; }
|
||||
|
||||
[JsonPropertyName("title")]
|
||||
public string Title { get; set; } = string.Empty;
|
||||
|
||||
[JsonPropertyName("body")]
|
||||
public string? Body { get; set; }
|
||||
|
||||
[JsonPropertyName("state")]
|
||||
public string State { get; set; } = string.Empty;
|
||||
|
||||
[JsonPropertyName("html_url")]
|
||||
public string HtmlUrl { get; set; } = string.Empty;
|
||||
|
||||
[JsonPropertyName("user")]
|
||||
public GiteaUser? User { get; set; }
|
||||
|
||||
[JsonPropertyName("labels")]
|
||||
public List<GiteaLabel>? Labels { get; set; }
|
||||
|
||||
[JsonPropertyName("assignees")]
|
||||
public List<GiteaUser>? Assignees { get; set; }
|
||||
|
||||
[JsonPropertyName("created_at")]
|
||||
public DateTimeOffset CreatedAt { get; set; }
|
||||
|
||||
[JsonPropertyName("updated_at")]
|
||||
public DateTimeOffset UpdatedAt { get; set; }
|
||||
|
||||
[JsonPropertyName("closed_at")]
|
||||
public DateTimeOffset? ClosedAt { get; set; }
|
||||
|
||||
[JsonPropertyName("comments")]
|
||||
public int Comments { get; set; }
|
||||
}
|
||||
|
||||
public class GiteaLabel
|
||||
{
|
||||
[JsonPropertyName("name")]
|
||||
public string Name { get; set; } = string.Empty;
|
||||
|
||||
[JsonPropertyName("color")]
|
||||
public string Color { get; set; } = string.Empty;
|
||||
}
|
||||
|
||||
public class GiteaComment
|
||||
{
|
||||
[JsonPropertyName("id")]
|
||||
public long Id { get; set; }
|
||||
|
||||
[JsonPropertyName("body")]
|
||||
public string? Body { get; set; }
|
||||
|
||||
[JsonPropertyName("user")]
|
||||
public GiteaUser? User { get; set; }
|
||||
|
||||
[JsonPropertyName("created_at")]
|
||||
public DateTimeOffset CreatedAt { get; set; }
|
||||
|
||||
[JsonPropertyName("updated_at")]
|
||||
public DateTimeOffset UpdatedAt { get; set; }
|
||||
}
|
||||
@@ -0,0 +1,43 @@
|
||||
using System.Text.Json.Serialization;
|
||||
|
||||
namespace GiteaMcp.Services.Models;
|
||||
|
||||
public class GiteaOrg
|
||||
{
|
||||
[JsonPropertyName("id")]
|
||||
public long Id { get; set; }
|
||||
|
||||
[JsonPropertyName("name")]
|
||||
public string Name { get; set; } = string.Empty;
|
||||
|
||||
[JsonPropertyName("full_name")]
|
||||
public string? FullName { get; set; }
|
||||
|
||||
[JsonPropertyName("description")]
|
||||
public string? Description { get; set; }
|
||||
|
||||
[JsonPropertyName("website")]
|
||||
public string? Website { get; set; }
|
||||
|
||||
[JsonPropertyName("location")]
|
||||
public string? Location { get; set; }
|
||||
|
||||
[JsonPropertyName("avatar_url")]
|
||||
public string? AvatarUrl { get; set; }
|
||||
|
||||
[JsonPropertyName("repo_admin_change_team_access")]
|
||||
public bool RepoAdminChangeTeamAccess { get; set; }
|
||||
|
||||
[JsonPropertyName("visibility")]
|
||||
public string? Visibility { get; set; }
|
||||
}
|
||||
|
||||
/// <summary>/api/v1/orgs/search 的响应包装（顶层 { ok, data }）。</summary>
|
||||
public class GiteaOrgSearchResult
|
||||
{
|
||||
[JsonPropertyName("ok")]
|
||||
public bool Ok { get; set; }
|
||||
|
||||
[JsonPropertyName("data")]
|
||||
public List<GiteaOrg> Data { get; set; } = [];
|
||||
}
|
||||
@@ -0,0 +1,27 @@
|
||||
using System.Text.Json.Serialization;
|
||||
|
||||
namespace GiteaMcp.Services.Models;
|
||||
|
||||
public class GiteaPackage
|
||||
{
|
||||
[JsonPropertyName("id")]
|
||||
public long Id { get; set; }
|
||||
|
||||
[JsonPropertyName("owner")]
|
||||
public GiteaUser? Owner { get; set; }
|
||||
|
||||
[JsonPropertyName("name")]
|
||||
public string Name { get; set; } = string.Empty;
|
||||
|
||||
[JsonPropertyName("type")]
|
||||
public string Type { get; set; } = string.Empty;
|
||||
|
||||
[JsonPropertyName("version")]
|
||||
public string Version { get; set; } = string.Empty;
|
||||
|
||||
[JsonPropertyName("creator")]
|
||||
public GiteaUser? Creator { get; set; }
|
||||
|
||||
[JsonPropertyName("created")]
|
||||
public DateTimeOffset Created { get; set; }
|
||||
}
|
||||
@@ -0,0 +1,85 @@
|
||||
using System.Text.Json.Serialization;
|
||||
|
||||
namespace GiteaMcp.Services.Models;
|
||||
|
||||
public class GiteaPullRequest
|
||||
{
|
||||
[JsonPropertyName("number")]
|
||||
public int Number { get; set; }
|
||||
|
||||
[JsonPropertyName("title")]
|
||||
public string Title { get; set; } = string.Empty;
|
||||
|
||||
[JsonPropertyName("body")]
|
||||
public string? Body { get; set; }
|
||||
|
||||
[JsonPropertyName("state")]
|
||||
public string State { get; set; } = string.Empty;
|
||||
|
||||
[JsonPropertyName("html_url")]
|
||||
public string HtmlUrl { get; set; } = string.Empty;
|
||||
|
||||
[JsonPropertyName("user")]
|
||||
public GiteaUser? User { get; set; }
|
||||
|
||||
[JsonPropertyName("head")]
|
||||
public GiteaPrRef? Head { get; set; }
|
||||
|
||||
[JsonPropertyName("base")]
|
||||
public GiteaPrRef? Base { get; set; }
|
||||
|
||||
[JsonPropertyName("merged")]
|
||||
public bool Merged { get; set; }
|
||||
|
||||
[JsonPropertyName("mergeable")]
|
||||
public bool? Mergeable { get; set; }
|
||||
|
||||
[JsonPropertyName("created_at")]
|
||||
public DateTimeOffset CreatedAt { get; set; }
|
||||
|
||||
[JsonPropertyName("updated_at")]
|
||||
public DateTimeOffset UpdatedAt { get; set; }
|
||||
|
||||
[JsonPropertyName("closed_at")]
|
||||
public DateTimeOffset? ClosedAt { get; set; }
|
||||
|
||||
[JsonPropertyName("merged_at")]
|
||||
public DateTimeOffset? MergedAt { get; set; }
|
||||
|
||||
[JsonPropertyName("labels")]
|
||||
public List<GiteaLabel>? Labels { get; set; }
|
||||
}
|
||||
|
||||
public class GiteaPrRef
|
||||
{
|
||||
[JsonPropertyName("label")]
|
||||
public string? Label { get; set; }
|
||||
|
||||
[JsonPropertyName("ref")]
|
||||
public string Ref { get; set; } = string.Empty;
|
||||
|
||||
[JsonPropertyName("sha")]
|
||||
public string Sha { get; set; } = string.Empty;
|
||||
|
||||
[JsonPropertyName("repo")]
|
||||
public GiteaRepo? Repo { get; set; }
|
||||
}
|
||||
|
||||
/// <summary>PR 变更文件（read_pull 附带返回）</summary>
|
||||
public class GiteaPrFile
|
||||
{
|
||||
[JsonPropertyName("filename")]
|
||||
public string Filename { get; set; } = string.Empty;
|
||||
|
||||
[JsonPropertyName("status")]
|
||||
public string Status { get; set; } = string.Empty;
|
||||
|
||||
[JsonPropertyName("additions")]
|
||||
public int Additions { get; set; }
|
||||
|
||||
[JsonPropertyName("deletions")]
|
||||
public int Deletions { get; set; }
|
||||
|
||||
[JsonPropertyName("changes")]
|
||||
public int Changes { get; set; }
|
||||
}
|
||||
@@ -0,0 +1,80 @@
|
||||
using System.Text.Json.Serialization;
|
||||
|
||||
namespace GiteaMcp.Services.Models;
|
||||
|
||||
/// <summary>Gitea 仓库元数据（list_repos / read_repo 使用）</summary>
|
||||
public class GiteaRepo
|
||||
{
|
||||
[JsonPropertyName("id")]
|
||||
public long Id { get; set; }
|
||||
|
||||
[JsonPropertyName("name")]
|
||||
public string Name { get; set; } = string.Empty;
|
||||
|
||||
[JsonPropertyName("full_name")]
|
||||
public string FullName { get; set; } = string.Empty;
|
||||
|
||||
[JsonPropertyName("description")]
|
||||
public string? Description { get; set; }
|
||||
|
||||
[JsonPropertyName("private")]
|
||||
public bool Private { get; set; }
|
||||
|
||||
[JsonPropertyName("fork")]
|
||||
public bool Fork { get; set; }
|
||||
|
||||
[JsonPropertyName("mirror")]
|
||||
public bool Mirror { get; set; }
|
||||
|
||||
[JsonPropertyName("archived")]
|
||||
public bool Archived { get; set; }
|
||||
|
||||
[JsonPropertyName("html_url")]
|
||||
public string HtmlUrl { get; set; } = string.Empty;
|
||||
|
||||
[JsonPropertyName("clone_url")]
|
||||
public string CloneUrl { get; set; } = string.Empty;
|
||||
|
||||
[JsonPropertyName("default_branch")]
|
||||
public string DefaultBranch { get; set; } = "main";
|
||||
|
||||
[JsonPropertyName("stars_count")]
|
||||
public int StarsCount { get; set; }
|
||||
|
||||
[JsonPropertyName("forks_count")]
|
||||
public int ForksCount { get; set; }
|
||||
|
||||
[JsonPropertyName("size")]
|
||||
public long Size { get; set; }
|
||||
|
||||
[JsonPropertyName("website")]
|
||||
public string? Website { get; set; }
|
||||
|
||||
[JsonPropertyName("topics")]
|
||||
public List<string>? Topics { get; set; }
|
||||
|
||||
[JsonPropertyName("updated_at")]
|
||||
public DateTimeOffset UpdatedAt { get; set; }
|
||||
|
||||
[JsonPropertyName("owner")]
|
||||
public GiteaUser? Owner { get; set; }
|
||||
}
|
||||
|
||||
public class GiteaUser
|
||||
{
|
||||
[JsonPropertyName("login")]
|
||||
public string Login { get; set; } = string.Empty;
|
||||
|
||||
[JsonPropertyName("full_name")]
|
||||
public string? FullName { get; set; }
|
||||
}
|
||||
|
||||
/// <summary>搜索仓库的 API 响应包装</summary>
|
||||
public class GiteaRepoSearchResult
|
||||
{
|
||||
[JsonPropertyName("data")]
|
||||
public List<GiteaRepo> Data { get; set; } = [];
|
||||
|
||||
[JsonPropertyName("ok")]
|
||||
public bool Ok { get; set; }
|
||||
}
|
||||
@@ -0,0 +1,50 @@
|
||||
using System.Text.Json.Serialization;
|
||||
|
||||
namespace GiteaMcp.Services.Models;
|
||||
|
||||
/// <summary>代码搜索结果条目（search_code 使用）</summary>
|
||||
public class GiteaSearchHit
|
||||
{
|
||||
/// <summary>仓库所有者</summary>
|
||||
public string Owner { get; set; } = string.Empty;
|
||||
|
||||
/// <summary>仓库名称</summary>
|
||||
public string Repo { get; set; } = string.Empty;
|
||||
|
||||
/// <summary>命中的文件路径（相对仓库根）</summary>
|
||||
public string Path { get; set; } = string.Empty;
|
||||
|
||||
/// <summary>命中的行号（1-based，Gitea 索引未启用时为 0）</summary>
|
||||
public int Line { get; set; }
|
||||
|
||||
/// <summary>命中行的前后上下文预览（Gitea 返回原始片段）</summary>
|
||||
public string Preview { get; set; } = string.Empty;
|
||||
}
|
||||
|
||||
/// <summary>Gitea code search API 返回的单条结果</summary>
|
||||
public class GiteaCodeSearchResult
|
||||
{
|
||||
[JsonPropertyName("filename")]
|
||||
public string Filename { get; set; } = string.Empty;
|
||||
|
||||
[JsonPropertyName("language")]
|
||||
public string? Language { get; set; }
|
||||
|
||||
[JsonPropertyName("content")]
|
||||
public string? Content { get; set; }
|
||||
|
||||
[JsonPropertyName("commit_id")]
|
||||
public string? CommitId { get; set; }
|
||||
|
||||
[JsonPropertyName("repo")]
|
||||
public GiteaRepo? Repo { get; set; }
|
||||
}
|
||||
|
||||
public class GiteaCodeSearchResponse
|
||||
{
|
||||
[JsonPropertyName("ok")]
|
||||
public bool Ok { get; set; }
|
||||
|
||||
[JsonPropertyName("data")]
|
||||
public List<GiteaCodeSearchResult> Data { get; set; } = [];
|
||||
}
|
||||
@@ -0,0 +1,69 @@
|
||||
using System.Text.Json.Serialization;
|
||||
|
||||
namespace GiteaMcp.Services.Models;
|
||||
|
||||
/// <summary>Git tree 中的单个条目（list_tree 使用）</summary>
|
||||
public class GiteaTreeEntry
|
||||
{
|
||||
[JsonPropertyName("path")]
|
||||
public string Path { get; set; } = string.Empty;
|
||||
|
||||
[JsonPropertyName("mode")]
|
||||
public string? Mode { get; set; }
|
||||
|
||||
/// <summary>"blob"（文件）/ "tree"（目录）/ "commit"（子模块）</summary>
|
||||
[JsonPropertyName("type")]
|
||||
public string Type { get; set; } = string.Empty;
|
||||
|
||||
[JsonPropertyName("size")]
|
||||
public long? Size { get; set; }
|
||||
|
||||
[JsonPropertyName("sha")]
|
||||
public string? Sha { get; set; }
|
||||
|
||||
[JsonPropertyName("url")]
|
||||
public string? Url { get; set; }
|
||||
}
|
||||
|
||||
public class GiteaTree
|
||||
{
|
||||
[JsonPropertyName("sha")]
|
||||
public string Sha { get; set; } = string.Empty;
|
||||
|
||||
[JsonPropertyName("url")]
|
||||
public string? Url { get; set; }
|
||||
|
||||
[JsonPropertyName("tree")]
|
||||
public List<GiteaTreeEntry> Tree { get; set; } = [];
|
||||
|
||||
[JsonPropertyName("truncated")]
|
||||
public bool Truncated { get; set; }
|
||||
}
|
||||
|
||||
/// <summary>分支信息（list_branches 使用）</summary>
|
||||
public class GiteaBranch
|
||||
{
|
||||
[JsonPropertyName("name")]
|
||||
public string Name { get; set; } = string.Empty;
|
||||
|
||||
[JsonPropertyName("commit")]
|
||||
public GiteaBranchCommit? Commit { get; set; }
|
||||
|
||||
[JsonPropertyName("protected")]
|
||||
public bool Protected { get; set; }
|
||||
}
|
||||
|
||||
public class GiteaBranchCommit
|
||||
{
|
||||
[JsonPropertyName("id")]
|
||||
public string Id { get; set; } = string.Empty;
|
||||
|
||||
[JsonPropertyName("message")]
|
||||
public string? Message { get; set; }
|
||||
|
||||
[JsonPropertyName("timestamp")]
|
||||
public DateTimeOffset Timestamp { get; set; }
|
||||
|
||||
[JsonPropertyName("author")]
|
||||
public GiteaCommitSignature? Author { get; set; }
|
||||
}
|
||||
@@ -0,0 +1,84 @@
|
||||
using System.Text.Json.Serialization;
|
||||
|
||||
namespace GiteaMcp.Services.Models;
|
||||
|
||||
public class GiteaWorkflowRun
|
||||
{
|
||||
[JsonPropertyName("id")]
|
||||
public long Id { get; set; }
|
||||
|
||||
[JsonPropertyName("name")]
|
||||
public string? Name { get; set; }
|
||||
|
||||
[JsonPropertyName("head_branch")]
|
||||
public string? HeadBranch { get; set; }
|
||||
|
||||
[JsonPropertyName("head_sha")]
|
||||
public string? HeadSha { get; set; }
|
||||
|
||||
[JsonPropertyName("event")]
|
||||
public string? Event { get; set; }
|
||||
|
||||
[JsonPropertyName("status")]
|
||||
public string? Status { get; set; }
|
||||
|
||||
[JsonPropertyName("conclusion")]
|
||||
public string? Conclusion { get; set; }
|
||||
|
||||
[JsonPropertyName("workflow_id")]
|
||||
public long WorkflowId { get; set; }
|
||||
|
||||
[JsonPropertyName("url")]
|
||||
public string? Url { get; set; }
|
||||
|
||||
[JsonPropertyName("html_url")]
|
||||
public string? HtmlUrl { get; set; }
|
||||
|
||||
[JsonPropertyName("created_at")]
|
||||
public DateTimeOffset CreatedAt { get; set; }
|
||||
|
||||
[JsonPropertyName("updated_at")]
|
||||
public DateTimeOffset UpdatedAt { get; set; }
|
||||
|
||||
[JsonPropertyName("actor")]
|
||||
public GiteaUser? Actor { get; set; }
|
||||
}
|
||||
|
||||
public class GiteaWorkflowRunList
|
||||
{
|
||||
[JsonPropertyName("workflow_runs")]
|
||||
public List<GiteaWorkflowRun> WorkflowRuns { get; set; } = [];
|
||||
|
||||
[JsonPropertyName("total_count")]
|
||||
public int TotalCount { get; set; }
|
||||
}
|
||||
|
||||
public class GiteaWorkflowJob
|
||||
{
|
||||
[JsonPropertyName("id")]
|
||||
public long Id { get; set; }
|
||||
|
||||
[JsonPropertyName("name")]
|
||||
public string? Name { get; set; }
|
||||
|
||||
[JsonPropertyName("status")]
|
||||
public string? Status { get; set; }
|
||||
|
||||
[JsonPropertyName("conclusion")]
|
||||
public string? Conclusion { get; set; }
|
||||
|
||||
[JsonPropertyName("started_at")]
|
||||
public DateTimeOffset? StartedAt { get; set; }
|
||||
|
||||
[JsonPropertyName("completed_at")]
|
||||
public DateTimeOffset? CompletedAt { get; set; }
|
||||
}
|
||||
|
||||
public class GiteaWorkflowJobList
|
||||
{
|
||||
[JsonPropertyName("workflow_jobs")]
|
||||
public List<GiteaWorkflowJob> WorkflowJobs { get; set; } = [];
|
||||
|
||||
[JsonPropertyName("total_count")]
|
||||
public int TotalCount { get; set; }
|
||||
}
|
||||
Reference in New Issue
Block a user