zhengchen.tao
c7fa6aeb7f
把 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>
99 lines
2.4 KiB
C#
99 lines
2.4 KiB
C#
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; }
|
|
}
|