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>
62 lines
2.5 KiB
C#
62 lines
2.5 KiB
C#
using GiteaMcp.Services;
|
||
using ModelContextProtocol.Server;
|
||
using System.ComponentModel;
|
||
|
||
namespace GiteaMcp.Tools;
|
||
|
||
/// <summary>Package Registry Tool：list_packages / read_package</summary>
|
||
[McpServerToolType]
|
||
public class PackageTools(GiteaApiClient gitea)
|
||
{
|
||
[McpServerTool]
|
||
[Description(
|
||
"List packages in Gitea's built-in package registry for a given owner (user or org). " +
|
||
"Supports all package types: container (Docker/OCI), generic, npm, pypi, maven, nuget, etc. " +
|
||
"Returns: package name, type, version, creator, and creation date. " +
|
||
"Use read_package to get detailed metadata (e.g. OCI manifest digest for container images).")]
|
||
public async Task<object> list_packages(
|
||
[Description("Owner (user login or org name) whose packages to list.")] string owner,
|
||
[Description("Package type filter: 'container', 'generic', 'npm', 'pypi', 'maven', 'nuget', etc. Omit for all types.")] string? type = null,
|
||
[Description("Max packages to return. Default 50.")] int? limit = null,
|
||
CancellationToken ct = default)
|
||
{
|
||
var lim = Math.Min(limit ?? 50, 50);
|
||
var packages = await gitea.GetPackagesAsync(owner, type, lim, ct);
|
||
|
||
return packages.Select(p => new
|
||
{
|
||
owner = p.Owner?.Login,
|
||
name = p.Name,
|
||
type = p.Type,
|
||
version = p.Version,
|
||
creator = p.Creator?.Login,
|
||
created = p.Created,
|
||
}).ToList();
|
||
}
|
||
|
||
[McpServerTool]
|
||
[Description(
|
||
"Get metadata for a specific package version in Gitea's package registry. " +
|
||
"For container images, this includes the OCI manifest digest and image details. " +
|
||
"Use list_packages to discover available packages and their versions.")]
|
||
public async Task<object> read_package(
|
||
[Description("Owner (user login or org name).")] string owner,
|
||
[Description("Package type: 'container', 'generic', 'npm', etc.")] string type,
|
||
[Description("Package name.")] string name,
|
||
[Description("Package version string (e.g. 'latest', '1.0.0', 'main').")] string version,
|
||
CancellationToken ct = default)
|
||
{
|
||
var pkg = await gitea.GetPackageAsync(owner, type, name, version, ct);
|
||
|
||
return new
|
||
{
|
||
owner = pkg.Owner?.Login,
|
||
name = pkg.Name,
|
||
type = pkg.Type,
|
||
version = pkg.Version,
|
||
creator = pkg.Creator?.Login,
|
||
created = pkg.Created,
|
||
};
|
||
}
|
||
}
|