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,15 @@
|
|||||||
|
**/.vs
|
||||||
|
**/.vscode
|
||||||
|
**/.idea
|
||||||
|
**/bin
|
||||||
|
**/obj
|
||||||
|
**/*.user
|
||||||
|
**/*.suo
|
||||||
|
.git
|
||||||
|
.gitea
|
||||||
|
.gitignore
|
||||||
|
.dockerignore
|
||||||
|
README.md
|
||||||
|
LICENSE
|
||||||
|
**/*.md
|
||||||
|
gitea-mcp.Tests/
|
||||||
@@ -0,0 +1,125 @@
|
|||||||
|
name: Build Docker Image
|
||||||
|
|
||||||
|
on:
|
||||||
|
push:
|
||||||
|
branches: [main]
|
||||||
|
paths-ignore:
|
||||||
|
- '**.md'
|
||||||
|
- 'LICENSE'
|
||||||
|
- '.gitignore'
|
||||||
|
- '.dockerignore'
|
||||||
|
- '.gitea/workflows/sync-upstream.yml'
|
||||||
|
workflow_dispatch:
|
||||||
|
inputs:
|
||||||
|
branch:
|
||||||
|
description: '要打包的分支（仅手动触发生效）'
|
||||||
|
required: true
|
||||||
|
default: 'main'
|
||||||
|
tag:
|
||||||
|
description: '镜像 tag（留空则用 commit short hash）'
|
||||||
|
required: false
|
||||||
|
default: ''
|
||||||
|
|
||||||
|
# 同一分支连续 push 只跑最新一个，旧 in-progress run 一起取消
|
||||||
|
concurrency:
|
||||||
|
group: ${{ github.workflow }}-${{ github.ref }}
|
||||||
|
cancel-in-progress: true
|
||||||
|
|
||||||
|
jobs:
|
||||||
|
build:
|
||||||
|
runs-on: ubuntu-latest
|
||||||
|
steps:
|
||||||
|
- name: Checkout target branch
|
||||||
|
uses: actions/checkout@v4
|
||||||
|
with:
|
||||||
|
ref: ${{ inputs.branch || github.ref_name }}
|
||||||
|
fetch-depth: 0
|
||||||
|
|
||||||
|
- name: Set up Docker Buildx
|
||||||
|
uses: docker/setup-buildx-action@v3
|
||||||
|
with:
|
||||||
|
# 钉 v0.13.2：runc 1.1.x，兼容 DSM 4.4.x 内核（不支持 openat2/fsmount）
|
||||||
|
driver-opts: |
|
||||||
|
image=moby/buildkit:v0.13.2
|
||||||
|
|
||||||
|
- name: Login to Gitea Container Registry
|
||||||
|
uses: docker/login-action@v3
|
||||||
|
with:
|
||||||
|
registry: git.zhengchentao.win
|
||||||
|
username: ${{ gitea.actor }}
|
||||||
|
password: ${{ secrets.PACKAGES_TOKEN }}
|
||||||
|
|
||||||
|
- name: Determine image tag
|
||||||
|
id: meta
|
||||||
|
run: |
|
||||||
|
if [ -n "${{ inputs.tag }}" ]; then
|
||||||
|
IMAGE_TAG="${{ inputs.tag }}"
|
||||||
|
else
|
||||||
|
IMAGE_TAG="$(git rev-parse --short HEAD)"
|
||||||
|
fi
|
||||||
|
echo "image_tag=$IMAGE_TAG" >> $GITHUB_OUTPUT
|
||||||
|
echo "full_sha=$(git rev-parse HEAD)" >> $GITHUB_OUTPUT
|
||||||
|
echo "==> Image tag: $IMAGE_TAG"
|
||||||
|
|
||||||
|
- name: Build and push
|
||||||
|
uses: docker/build-push-action@v5
|
||||||
|
with:
|
||||||
|
context: .
|
||||||
|
push: true
|
||||||
|
labels: |
|
||||||
|
org.opencontainers.image.source=https://git.zhengchentao.win/zhengchen.tao/gitea-mcp
|
||||||
|
org.opencontainers.image.revision=${{ steps.meta.outputs.full_sha }}
|
||||||
|
tags: |
|
||||||
|
git.zhengchentao.win/zhengchen.tao/gitea-mcp:${{ steps.meta.outputs.image_tag }}
|
||||||
|
git.zhengchentao.win/zhengchen.tao/gitea-mcp:latest
|
||||||
|
|
||||||
|
- name: Build summary
|
||||||
|
if: always()
|
||||||
|
run: |
|
||||||
|
{
|
||||||
|
echo "## Build Summary"
|
||||||
|
echo ""
|
||||||
|
echo "| 项 | 值 |"
|
||||||
|
echo "|---|---|"
|
||||||
|
echo "| 触发方式 | \`${{ github.event_name }}\` |"
|
||||||
|
echo "| 源分支 | \`${{ github.ref_name }}\` |"
|
||||||
|
echo "| Commit (full) | \`${{ steps.meta.outputs.full_sha }}\` |"
|
||||||
|
echo "| 镜像 tag | \`git.zhengchentao.win/zhengchen.tao/gitea-mcp:${{ steps.meta.outputs.image_tag }}\` + \`:latest\` |"
|
||||||
|
} >> "$GITHUB_STEP_SUMMARY"
|
||||||
|
|
||||||
|
deploy:
|
||||||
|
needs: build
|
||||||
|
runs-on: ubuntu-latest
|
||||||
|
steps:
|
||||||
|
# deploy job 是独立 runner，凭据不跨 job 继承，必须再 login 一次
|
||||||
|
- name: Login to Gitea Container Registry
|
||||||
|
uses: docker/login-action@v3
|
||||||
|
with:
|
||||||
|
registry: git.zhengchentao.win
|
||||||
|
username: ${{ gitea.actor }}
|
||||||
|
password: ${{ secrets.PACKAGES_TOKEN }}
|
||||||
|
|
||||||
|
- name: Pull and restart gitea-mcp
|
||||||
|
env:
|
||||||
|
NAS_INFRA_TOKEN: ${{ secrets.NAS_INFRA_TOKEN }}
|
||||||
|
run: |
|
||||||
|
set -e
|
||||||
|
|
||||||
|
TMPDIR=$(mktemp -d)
|
||||||
|
trap 'rm -rf "$TMPDIR"' EXIT
|
||||||
|
|
||||||
|
if [ -n "$NAS_INFRA_TOKEN" ]; then
|
||||||
|
CLONE_URL="https://x-access-token:${NAS_INFRA_TOKEN}@git.zhengchentao.win/dev/nas-infra.git"
|
||||||
|
else
|
||||||
|
CLONE_URL="https://git.zhengchentao.win/dev/nas-infra.git"
|
||||||
|
fi
|
||||||
|
|
||||||
|
git clone --depth 1 "$CLONE_URL" "$TMPDIR/nas-infra"
|
||||||
|
cd "$TMPDIR/nas-infra/gitea-mcp"
|
||||||
|
|
||||||
|
docker compose pull
|
||||||
|
docker compose up -d
|
||||||
|
|
||||||
|
sleep 3
|
||||||
|
docker compose ps
|
||||||
|
docker compose logs --tail=30 gitea-mcp
|
||||||
+36
@@ -0,0 +1,36 @@
|
|||||||
|
## .gitignore for .NET 10 project
|
||||||
|
|
||||||
|
# Build outputs
|
||||||
|
bin/
|
||||||
|
obj/
|
||||||
|
|
||||||
|
# User-specific files
|
||||||
|
*.user
|
||||||
|
*.suo
|
||||||
|
.vs/
|
||||||
|
|
||||||
|
# dotnet user-jwts (development JWT store)
|
||||||
|
Properties/launchSettings.json
|
||||||
|
|
||||||
|
# macOS
|
||||||
|
.DS_Store
|
||||||
|
|
||||||
|
# Environment files (never commit secrets)
|
||||||
|
.env
|
||||||
|
.env.*
|
||||||
|
!.env.example
|
||||||
|
|
||||||
|
# Logs
|
||||||
|
logs/
|
||||||
|
*.log
|
||||||
|
|
||||||
|
# NuGet
|
||||||
|
*.nupkg
|
||||||
|
.nuget/
|
||||||
|
|
||||||
|
# Rider / JetBrains
|
||||||
|
.idea/
|
||||||
|
|
||||||
|
# VS Code (allow settings but not per-user state)
|
||||||
|
.vscode/launch.json
|
||||||
|
.vscode/*.code-workspace
|
||||||
@@ -0,0 +1,68 @@
|
|||||||
|
using GiteaMcp.Config;
|
||||||
|
using Microsoft.AspNetCore.Authentication.JwtBearer;
|
||||||
|
using Microsoft.IdentityModel.Tokens;
|
||||||
|
using System.Text;
|
||||||
|
|
||||||
|
namespace GiteaMcp.Auth;
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// JWT Bearer 验签配置，与 obsidian-mcp 同款 HS256 对称密钥方案。
|
||||||
|
/// ValidIssuer = https://auth.zhengchentao.win，ValidAudience = gitea。
|
||||||
|
/// 支持 Current + Previous 双密钥（轮换窗口）。
|
||||||
|
/// </summary>
|
||||||
|
public static class JwtBearerSetup
|
||||||
|
{
|
||||||
|
public static IServiceCollection AddGiteaJwtBearer(
|
||||||
|
this IServiceCollection services,
|
||||||
|
IConfiguration configuration)
|
||||||
|
{
|
||||||
|
var jwtOpts = configuration.GetSection(JwtOptions.SectionName).Get<JwtOptions>()
|
||||||
|
?? new JwtOptions();
|
||||||
|
|
||||||
|
services
|
||||||
|
.AddAuthentication(JwtBearerDefaults.AuthenticationScheme)
|
||||||
|
.AddJwtBearer(options =>
|
||||||
|
{
|
||||||
|
// 关闭默认的入站 claim type 映射，否则 "sub"/"scope" 会被改写成
|
||||||
|
// ClaimTypes.NameIdentifier 之类的长 URI，下游 FindFirst("scope") 取不到。
|
||||||
|
options.MapInboundClaims = false;
|
||||||
|
|
||||||
|
options.TokenValidationParameters = new TokenValidationParameters
|
||||||
|
{
|
||||||
|
ValidateIssuer = true,
|
||||||
|
ValidIssuer = jwtOpts.Issuer,
|
||||||
|
|
||||||
|
ValidateAudience = true,
|
||||||
|
ValidAudience = jwtOpts.Audience,
|
||||||
|
|
||||||
|
ValidateIssuerSigningKey = true,
|
||||||
|
// ToList 物化一次，避免每次验签重建 SymmetricSecurityKey。
|
||||||
|
IssuerSigningKeys = BuildSigningKeys(jwtOpts).ToList(),
|
||||||
|
|
||||||
|
ValidateLifetime = true,
|
||||||
|
// nas-auth 设计里允许 2 分钟时钟偏差
|
||||||
|
ClockSkew = TimeSpan.FromMinutes(2),
|
||||||
|
};
|
||||||
|
});
|
||||||
|
|
||||||
|
return services;
|
||||||
|
}
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// 构建 Current + Previous 双密钥列表，供 SDK 依次尝试验签。
|
||||||
|
/// 轮换期间两把钥匙同时有效，过期的旧 Token 会被 ValidateLifetime 自然拦截。
|
||||||
|
/// Current 未配置直接抛错，避免容器静默以"任何 token 都不通过"的状态运行。
|
||||||
|
/// </summary>
|
||||||
|
private static IEnumerable<SecurityKey> BuildSigningKeys(JwtOptions opts)
|
||||||
|
{
|
||||||
|
if (string.IsNullOrWhiteSpace(opts.SigningKeyCurrent))
|
||||||
|
throw new InvalidOperationException(
|
||||||
|
"Jwt:SigningKeyCurrent 未配置，gitea-mcp 无法启动。" +
|
||||||
|
"请在 .env.shared 设置 JWT_SIGNING_KEY_CURRENT 与 nas-auth 共用。");
|
||||||
|
|
||||||
|
yield return new SymmetricSecurityKey(Encoding.UTF8.GetBytes(opts.SigningKeyCurrent));
|
||||||
|
|
||||||
|
if (!string.IsNullOrWhiteSpace(opts.SigningKeyPrevious))
|
||||||
|
yield return new SymmetricSecurityKey(Encoding.UTF8.GetBytes(opts.SigningKeyPrevious));
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,59 @@
|
|||||||
|
using Microsoft.AspNetCore.Authorization;
|
||||||
|
|
||||||
|
namespace GiteaMcp.Auth;
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// 自定义 scope 授权策略：要求 JWT 的 scope claim 包含指定值。
|
||||||
|
/// 对应 RequireScope("read:gitea") policy。
|
||||||
|
/// </summary>
|
||||||
|
public static class ScopePolicies
|
||||||
|
{
|
||||||
|
public const string ReadGitea = "read:gitea";
|
||||||
|
|
||||||
|
public static IServiceCollection AddScopePolicies(this IServiceCollection services)
|
||||||
|
{
|
||||||
|
services.AddAuthorizationBuilder()
|
||||||
|
.AddPolicy(ReadGitea, policy =>
|
||||||
|
{
|
||||||
|
policy.RequireAuthenticatedUser();
|
||||||
|
policy.AddRequirements(new ScopeRequirement(ReadGitea));
|
||||||
|
});
|
||||||
|
|
||||||
|
services.AddSingleton<IAuthorizationHandler, ScopeRequirementHandler>();
|
||||||
|
return services;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// 授权要求：JWT scope claim 必须包含指定的 scope 字符串（空格分隔的多 scope 支持）。
|
||||||
|
/// </summary>
|
||||||
|
public class ScopeRequirement(string scope) : IAuthorizationRequirement
|
||||||
|
{
|
||||||
|
public string Scope { get; } = scope;
|
||||||
|
}
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// 验证 scope claim。
|
||||||
|
/// nas-auth 签发的 JWT 里 scope 是单字符串（空格分隔），形如 "read:gitea" 或 "read:gitea write:gitea"。
|
||||||
|
/// 兼容部分实现把多 scope 拆成多个 claim 的形式（FindAll）。
|
||||||
|
/// OAuth 2.0 (RFC 6749 §3.3) 规定 scope 大小写敏感。
|
||||||
|
/// </summary>
|
||||||
|
public class ScopeRequirementHandler : AuthorizationHandler<ScopeRequirement>
|
||||||
|
{
|
||||||
|
protected override Task HandleRequirementAsync(
|
||||||
|
AuthorizationHandlerContext context,
|
||||||
|
ScopeRequirement requirement)
|
||||||
|
{
|
||||||
|
var scopes = context.User
|
||||||
|
.FindAll("scope")
|
||||||
|
.SelectMany(c => c.Value.Split(' ', StringSplitOptions.RemoveEmptyEntries))
|
||||||
|
.ToHashSet(StringComparer.Ordinal);
|
||||||
|
|
||||||
|
if (scopes.Contains(requirement.Scope))
|
||||||
|
{
|
||||||
|
context.Succeed(requirement);
|
||||||
|
}
|
||||||
|
|
||||||
|
return Task.CompletedTask;
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,32 @@
|
|||||||
|
namespace GiteaMcp.Config;
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Gitea 后端连接配置，通过 env / appsettings 注入。
|
||||||
|
/// 生产环境敏感字段（AdminPat）必须通过 .env.shared 注入，不要写进代码。
|
||||||
|
/// </summary>
|
||||||
|
public class GiteaOptions
|
||||||
|
{
|
||||||
|
public const string SectionName = "Gitea";
|
||||||
|
|
||||||
|
/// <summary>Gitea 根 URL，例如 https://git.zhengchentao.win（末尾无斜杠）</summary>
|
||||||
|
public string BaseUrl { get; set; } = "https://git.zhengchentao.win";
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Gitea Admin PAT（只读权限：read:repository / read:issue / read:user / read:organization / read:package）。
|
||||||
|
/// 生产环境从 env Gitea__AdminPat 注入，本地开发用 dotnet user-secrets。
|
||||||
|
/// 绝对不要 hardcode。
|
||||||
|
/// </summary>
|
||||||
|
public string AdminPat { get; set; } = string.Empty;
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// 黑名单：逗号分隔的 owner/repo，格式如 "zhengchen.tao/secret-repo,org/internal"。
|
||||||
|
/// 黑名单内的 repo 不会出现在任何 Tool 的返回值里。默认空（全开放）。
|
||||||
|
/// </summary>
|
||||||
|
public string RepoBlacklist { get; set; } = string.Empty;
|
||||||
|
|
||||||
|
/// <summary>list_repos 的默认 limit（不传时使用）</summary>
|
||||||
|
public int DefaultLimit { get; set; } = 50;
|
||||||
|
|
||||||
|
/// <summary>read_file 的默认最大字节数（1MB）</summary>
|
||||||
|
public int MaxFileBytes { get; set; } = 1 * 1024 * 1024;
|
||||||
|
}
|
||||||
@@ -0,0 +1,22 @@
|
|||||||
|
namespace GiteaMcp.Config;
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// JWT 验签配置，与 nas-auth / obsidian-mcp 共用同款 HS256 对称密钥。
|
||||||
|
/// ValidIssuer = auth.zhengchentao.win，ValidAudience = gitea。
|
||||||
|
/// </summary>
|
||||||
|
public class JwtOptions
|
||||||
|
{
|
||||||
|
public const string SectionName = "Jwt";
|
||||||
|
|
||||||
|
public string Issuer { get; set; } = "https://auth.zhengchentao.win";
|
||||||
|
public string Audience { get; set; } = "gitea";
|
||||||
|
|
||||||
|
/// <summary>当前签名密钥（HS256 对称密钥，base64 或原文均可，长度 >= 32 字节）</summary>
|
||||||
|
public string SigningKeyCurrent { get; set; } = string.Empty;
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// 上一轮密钥（轮换窗口内保留，允许旧 Token 继续使用）。
|
||||||
|
/// 留空表示不存在旧密钥。
|
||||||
|
/// </summary>
|
||||||
|
public string SigningKeyPrevious { get; set; } = string.Empty;
|
||||||
|
}
|
||||||
@@ -0,0 +1,15 @@
|
|||||||
|
namespace GiteaMcp.Config;
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// /.well-known/oauth-authorization-server 端点返回的静态元数据，
|
||||||
|
/// 字段由 Mcp:OAuthDiscovery:* 配置项驱动。
|
||||||
|
/// </summary>
|
||||||
|
public class McpDiscoveryOptions
|
||||||
|
{
|
||||||
|
public const string SectionName = "Mcp:OAuthDiscovery";
|
||||||
|
|
||||||
|
public string Issuer { get; set; } = "https://auth.zhengchentao.win";
|
||||||
|
public string AuthorizationEndpoint { get; set; } = "https://auth.zhengchentao.win/authorize";
|
||||||
|
public string TokenEndpoint { get; set; } = "https://auth.zhengchentao.win/token";
|
||||||
|
public string RegistrationEndpoint { get; set; } = "https://auth.zhengchentao.win/register";
|
||||||
|
}
|
||||||
+40
@@ -0,0 +1,40 @@
|
|||||||
|
# ── Stage 1: build ──────────────────────────────────────────────
|
||||||
|
FROM mcr.microsoft.com/dotnet/sdk:10.0 AS builder
|
||||||
|
|
||||||
|
WORKDIR /src
|
||||||
|
|
||||||
|
# 先复制 csproj，单独 restore（利用层缓存）
|
||||||
|
COPY gitea-mcp.csproj .
|
||||||
|
RUN dotnet restore gitea-mcp.csproj
|
||||||
|
|
||||||
|
# 复制剩余源码并发布
|
||||||
|
COPY . .
|
||||||
|
RUN dotnet publish gitea-mcp.csproj \
|
||||||
|
-c Release \
|
||||||
|
-o /app/publish \
|
||||||
|
--no-restore
|
||||||
|
|
||||||
|
# ── Stage 2: runtime ────────────────────────────────────────────
|
||||||
|
FROM mcr.microsoft.com/dotnet/aspnet:10.0 AS runtime
|
||||||
|
|
||||||
|
# OCI 标签（CI 会在 build-push 时注入 revision）
|
||||||
|
LABEL org.opencontainers.image.title="gitea-mcp"
|
||||||
|
LABEL org.opencontainers.image.description="MCP server exposing Gitea REST API to Claude via nas-auth JWT"
|
||||||
|
LABEL org.opencontainers.image.source="https://git.zhengchentao.win/zhengchen.tao/gitea-mcp"
|
||||||
|
LABEL org.opencontainers.image.licenses="MIT"
|
||||||
|
|
||||||
|
WORKDIR /app
|
||||||
|
|
||||||
|
# 非 root 用户运行（最小权限）。
|
||||||
|
# 先建用户、再 COPY --chown，确保拷进来的文件归属正确（不能依赖默认 644 让 appuser 兜底读）。
|
||||||
|
RUN adduser --disabled-password --gecos "" appuser
|
||||||
|
COPY --from=builder --chown=appuser:appuser /app/publish .
|
||||||
|
USER appuser
|
||||||
|
|
||||||
|
# 容器内监听 0.0.0.0:8080，宿主机映射到 9092
|
||||||
|
ENV ASPNETCORE_URLS=http://0.0.0.0:8080
|
||||||
|
ENV ASPNETCORE_ENVIRONMENT=Production
|
||||||
|
|
||||||
|
EXPOSE 8080
|
||||||
|
|
||||||
|
ENTRYPOINT ["dotnet", "gitea-mcp.dll"]
|
||||||
@@ -0,0 +1,33 @@
|
|||||||
|
using GiteaMcp.Config;
|
||||||
|
using Microsoft.Extensions.Options;
|
||||||
|
|
||||||
|
namespace GiteaMcp.Endpoints;
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// OAuth 2.0 Authorization Server Metadata（RFC 8414）端点。
|
||||||
|
/// Claude.ai 在接入 custom connector 时会先访问 /.well-known/oauth-authorization-server，
|
||||||
|
/// 根据返回的元数据找到 nas-auth 的 authorize / token / register 端点。
|
||||||
|
/// </summary>
|
||||||
|
public static class DiscoveryEndpoints
|
||||||
|
{
|
||||||
|
public static IEndpointRouteBuilder MapDiscovery(this IEndpointRouteBuilder app)
|
||||||
|
{
|
||||||
|
app.MapGet("/.well-known/oauth-authorization-server", (IOptions<McpDiscoveryOptions> opts) =>
|
||||||
|
{
|
||||||
|
var o = opts.Value;
|
||||||
|
return Results.Ok(new
|
||||||
|
{
|
||||||
|
issuer = o.Issuer,
|
||||||
|
authorization_endpoint = o.AuthorizationEndpoint,
|
||||||
|
token_endpoint = o.TokenEndpoint,
|
||||||
|
registration_endpoint = o.RegistrationEndpoint,
|
||||||
|
response_types_supported = new[] { "code" },
|
||||||
|
grant_types_supported = new[] { "authorization_code", "refresh_token" },
|
||||||
|
code_challenge_methods_supported = new[] { "S256" },
|
||||||
|
scopes_supported = new[] { "read:gitea" },
|
||||||
|
});
|
||||||
|
});
|
||||||
|
|
||||||
|
return app;
|
||||||
|
}
|
||||||
|
}
|
||||||
+85
@@ -0,0 +1,85 @@
|
|||||||
|
using GiteaMcp.Auth;
|
||||||
|
using GiteaMcp.Config;
|
||||||
|
using GiteaMcp.Endpoints;
|
||||||
|
using GiteaMcp.Services;
|
||||||
|
using Microsoft.Extensions.Http.Resilience;
|
||||||
|
using System.Net;
|
||||||
|
using System.Net.Http.Headers;
|
||||||
|
|
||||||
|
var builder = WebApplication.CreateBuilder(args);
|
||||||
|
|
||||||
|
// ─── 配置绑定 ───────────────────────────────────────────────
|
||||||
|
builder.Services.Configure<GiteaOptions>(
|
||||||
|
builder.Configuration.GetSection(GiteaOptions.SectionName));
|
||||||
|
builder.Services.Configure<JwtOptions>(
|
||||||
|
builder.Configuration.GetSection(JwtOptions.SectionName));
|
||||||
|
builder.Services.Configure<McpDiscoveryOptions>(
|
||||||
|
builder.Configuration.GetSection(McpDiscoveryOptions.SectionName));
|
||||||
|
|
||||||
|
// ─── JWT Bearer + Scope Policy ─────────────────────────────
|
||||||
|
builder.Services.AddGiteaJwtBearer(builder.Configuration);
|
||||||
|
builder.Services.AddScopePolicies();
|
||||||
|
|
||||||
|
// ─── HTTP Context Accessor（Tool 里可选用，暂保留接口） ────────
|
||||||
|
builder.Services.AddHttpContextAccessor();
|
||||||
|
|
||||||
|
// ─── Gitea HTTP Client ─────────────────────────────────────
|
||||||
|
var giteaBaseUrl = builder.Configuration["Gitea:BaseUrl"]
|
||||||
|
?? "https://git.zhengchentao.win";
|
||||||
|
var giteaPat = builder.Configuration["Gitea:AdminPat"] ?? string.Empty;
|
||||||
|
|
||||||
|
builder.Services.AddHttpClient("gitea", client =>
|
||||||
|
{
|
||||||
|
// 确保 BaseAddress 末尾有斜杠（HttpClient 的规范）
|
||||||
|
var url = giteaBaseUrl.TrimEnd('/') + "/";
|
||||||
|
client.BaseAddress = new Uri(url);
|
||||||
|
|
||||||
|
// Gitea 推荐 "token <PAT>" 格式，比 Bearer 更稳
|
||||||
|
client.DefaultRequestHeaders.Authorization =
|
||||||
|
new AuthenticationHeaderValue("token", giteaPat);
|
||||||
|
|
||||||
|
client.DefaultRequestHeaders.Accept.Add(
|
||||||
|
new MediaTypeWithQualityHeaderValue("application/json"));
|
||||||
|
|
||||||
|
// 单请求超时 30s
|
||||||
|
client.Timeout = TimeSpan.FromSeconds(30);
|
||||||
|
})
|
||||||
|
.AddStandardResilienceHandler(options =>
|
||||||
|
{
|
||||||
|
// 3 次重试，指数退避（Microsoft.Extensions.Http.Resilience 标准配置）
|
||||||
|
options.Retry.MaxRetryAttempts = 3;
|
||||||
|
options.Retry.BackoffType = Polly.DelayBackoffType.Exponential;
|
||||||
|
options.Retry.Delay = TimeSpan.FromSeconds(1);
|
||||||
|
options.Retry.UseJitter = true;
|
||||||
|
// 仅对 5xx / 429 / 网络错误重试；4xx 由 ShouldHandle 默认配置自动跳过
|
||||||
|
options.TotalRequestTimeout.Timeout = TimeSpan.FromSeconds(90);
|
||||||
|
options.AttemptTimeout.Timeout = TimeSpan.FromSeconds(30);
|
||||||
|
});
|
||||||
|
|
||||||
|
// ─── 业务服务 ──────────────────────────────────────────────
|
||||||
|
builder.Services.AddSingleton<GiteaRepoFilter>();
|
||||||
|
builder.Services.AddScoped<GiteaApiClient>();
|
||||||
|
|
||||||
|
// ─── MCP Server ────────────────────────────────────────────
|
||||||
|
builder.Services.AddMcpServer()
|
||||||
|
.WithHttpTransport() // Streamable HTTP（Claude.ai custom connector 走这个）
|
||||||
|
.WithToolsFromAssembly(); // 自动扫描 [McpServerToolType]
|
||||||
|
|
||||||
|
// ─── Build ─────────────────────────────────────────────────
|
||||||
|
var app = builder.Build();
|
||||||
|
|
||||||
|
// ─── Middleware 顺序：认证 → 授权 → 路由 ────────────────────
|
||||||
|
app.UseAuthentication();
|
||||||
|
app.UseAuthorization();
|
||||||
|
|
||||||
|
// ─── Endpoints ─────────────────────────────────────────────
|
||||||
|
app.MapDiscovery();
|
||||||
|
|
||||||
|
// MCP 端点：要求通过 JWT 认证 + read:gitea scope
|
||||||
|
app.MapMcp("/mcp")
|
||||||
|
.RequireAuthorization(ScopePolicies.ReadGitea);
|
||||||
|
|
||||||
|
// 健康检查（Kubernetes / Docker healthcheck 用）
|
||||||
|
app.MapGet("/healthz", () => Results.Ok(new { status = "ok", timestamp = DateTimeOffset.UtcNow }));
|
||||||
|
|
||||||
|
app.Run();
|
||||||
@@ -0,0 +1,161 @@
|
|||||||
|
# gitea-mcp
|
||||||
|
|
||||||
|
Read access to all Gitea repos (public + private, personal + org) via MCP.
|
||||||
|
OAuth via nas-auth (DCR + PKCE + JWT HS256), admin PAT held internally — Claude never touches the PAT.
|
||||||
|
|
||||||
|
## Architecture
|
||||||
|
|
||||||
|
```
|
||||||
|
Claude.ai (MCP client)
|
||||||
|
│
|
||||||
|
│ ① GET /.well-known/oauth-authorization-server
|
||||||
|
↓
|
||||||
|
git-mcp.zhengchentao.win ←── this service
|
||||||
|
│
|
||||||
|
│ ② DCR + PKCE auth flow redirect
|
||||||
|
↓
|
||||||
|
auth.zhengchentao.win ←── nas-auth
|
||||||
|
│
|
||||||
|
│ ③ JWT (aud=gitea, scope=read:gitea)
|
||||||
|
↓
|
||||||
|
Claude.ai → Bearer JWT
|
||||||
|
│
|
||||||
|
│ ④ POST /mcp (MCP Streamable HTTP)
|
||||||
|
↓
|
||||||
|
git-mcp.zhengchentao.win
|
||||||
|
│ Bearer <GITEA_ADMIN_PAT>
|
||||||
|
↓
|
||||||
|
git.zhengchentao.win ←── Gitea
|
||||||
|
```
|
||||||
|
|
||||||
|
See [gitea-mcp 设计.md](../Coding/gitea-mcp/gitea-mcp%20设计.md) for full design rationale.
|
||||||
|
|
||||||
|
## Tools
|
||||||
|
|
||||||
|
| Tool | Description |
|
||||||
|
|------|-------------|
|
||||||
|
| `list_repos` | List all repos (personal + org, public + private) |
|
||||||
|
| `read_repo` | Repo metadata: topics, stars, default branch, mirror flag |
|
||||||
|
| `list_tree` | File tree at a ref (recursive optional, max 500 entries) |
|
||||||
|
| `read_file` | Raw file content (UTF-8, truncated at 1MB) |
|
||||||
|
| `search_code` | Code search via Gitea indexer (requires indexer enabled) |
|
||||||
|
| `list_branches` | Branch list + last commit per branch |
|
||||||
|
| `list_commits` | Recent commits with author + message |
|
||||||
|
| `read_commit` | Full commit details + per-file diff (max 50 files) |
|
||||||
|
| `list_issues` | Issues filtered by state (open/closed/all) |
|
||||||
|
| `read_issue` | Issue body + all comments |
|
||||||
|
| `list_pulls` | Pull requests filtered by state |
|
||||||
|
| `read_pull` | PR body + review comments + changed files |
|
||||||
|
| `list_orgs` | All organizations visible to admin token |
|
||||||
|
| `read_org` | Org metadata |
|
||||||
|
| `list_packages` | Packages in registry by owner (container/generic/npm/...) |
|
||||||
|
| `read_package` | Package version metadata |
|
||||||
|
| `list_workflow_runs` | Gitea Actions workflow run history |
|
||||||
|
| `read_run_log` | Run details + job list + log (truncated at 1MB) |
|
||||||
|
|
||||||
|
All tools require a valid JWT with `scope=read:gitea` issued by nas-auth.
|
||||||
|
|
||||||
|
## Configuration (env vars)
|
||||||
|
|
||||||
|
| Variable | Default | Description |
|
||||||
|
|----------|---------|-------------|
|
||||||
|
| `Gitea__BaseUrl` | `https://git.zhengchentao.win` | Gitea backend URL |
|
||||||
|
| `Gitea__AdminPat` | *(required)* | Gitea read-only PAT — see PAT Setup below |
|
||||||
|
| `Gitea__RepoBlacklist` | *(empty)* | Comma-separated `owner/repo` pairs to hide from Claude |
|
||||||
|
| `Gitea__DefaultLimit` | `50` | Default page size for list operations |
|
||||||
|
| `Gitea__MaxFileBytes` | `1048576` | Max file read size in bytes (1MB) |
|
||||||
|
| `Jwt__Issuer` | `https://auth.zhengchentao.win` | Expected JWT issuer |
|
||||||
|
| `Jwt__Audience` | `gitea` | Expected JWT audience |
|
||||||
|
| `Jwt__SigningKeyCurrent` | *(required)* | HS256 signing key (shared with nas-auth) |
|
||||||
|
| `Jwt__SigningKeyPrevious` | *(empty)* | Previous key for rotation window |
|
||||||
|
| `ASPNETCORE_ENVIRONMENT` | `Production` | Use `Development` locally |
|
||||||
|
|
||||||
|
All secrets come from `/volume1/docker/compose/.env.shared` on NAS — never hardcode them.
|
||||||
|
|
||||||
|
## Local Development
|
||||||
|
|
||||||
|
### 1. Restore and run
|
||||||
|
|
||||||
|
```bash
|
||||||
|
dotnet restore
|
||||||
|
dotnet run
|
||||||
|
# Listens on http://localhost:5000
|
||||||
|
```
|
||||||
|
|
||||||
|
### 2. Generate a dev JWT
|
||||||
|
|
||||||
|
Use `dotnet user-jwts` to sign a token without running nas-auth:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
dotnet user-jwts create \
|
||||||
|
--issuer https://auth.zhengchentao.win \
|
||||||
|
--audience gitea \
|
||||||
|
--name tao \
|
||||||
|
--claim sub=tao \
|
||||||
|
--claim scope=read:gitea
|
||||||
|
```
|
||||||
|
|
||||||
|
Or use [jwt.io](https://jwt.io) with alg=HS256 and the key from `Jwt:SigningKeyCurrent`.
|
||||||
|
|
||||||
|
### 3. Test with MCP Inspector
|
||||||
|
|
||||||
|
```bash
|
||||||
|
npx @modelcontextprotocol/inspector
|
||||||
|
# Transport: Streamable HTTP
|
||||||
|
# URL: http://localhost:5000/mcp
|
||||||
|
# Bearer Token: <token from step 2>
|
||||||
|
```
|
||||||
|
|
||||||
|
### 4. Run unit tests
|
||||||
|
|
||||||
|
```bash
|
||||||
|
dotnet test gitea-mcp.Tests/
|
||||||
|
```
|
||||||
|
|
||||||
|
## PAT Setup (Gitea → Settings → Applications)
|
||||||
|
|
||||||
|
Generate a token with **only these scopes** (principle of least privilege):
|
||||||
|
|
||||||
|
- `read:repository`
|
||||||
|
- `read:organization`
|
||||||
|
- `read:package`
|
||||||
|
- `read:issue`
|
||||||
|
- `read:user`
|
||||||
|
|
||||||
|
Do NOT grant `write:*` or `admin:*` scopes.
|
||||||
|
Store the generated token in `.env.shared` as `GITEA_MCP_PAT=<token>`.
|
||||||
|
|
||||||
|
If the PAT is compromised: revoke in Gitea → generate new → update `.env.shared` → `docker compose up -d gitea-mcp`.
|
||||||
|
|
||||||
|
## Docker Compose (NAS deployment)
|
||||||
|
|
||||||
|
```yaml
|
||||||
|
# /volume1/docker/compose/gitea-mcp/docker-compose.yml
|
||||||
|
services:
|
||||||
|
gitea-mcp:
|
||||||
|
image: git.zhengchentao.win/zhengchen.tao/gitea-mcp:latest
|
||||||
|
container_name: gitea-mcp
|
||||||
|
restart: unless-stopped
|
||||||
|
ports:
|
||||||
|
- "9092:8080"
|
||||||
|
volumes:
|
||||||
|
- /volume1/docker/gitea-mcp/logs:/app/logs
|
||||||
|
environment:
|
||||||
|
- ASPNETCORE_ENVIRONMENT=Production
|
||||||
|
- Gitea__BaseUrl=https://git.zhengchentao.win
|
||||||
|
- Gitea__AdminPat=${GITEA_MCP_PAT}
|
||||||
|
- Gitea__RepoBlacklist=
|
||||||
|
- Jwt__Issuer=https://auth.zhengchentao.win
|
||||||
|
- Jwt__Audience=gitea
|
||||||
|
- Jwt__SigningKeyCurrent=${JWT_SIGNING_KEY_CURRENT}
|
||||||
|
- TZ=Asia/Shanghai
|
||||||
|
env_file:
|
||||||
|
- ../.env.shared
|
||||||
|
```
|
||||||
|
|
||||||
|
## Related Documents
|
||||||
|
|
||||||
|
- [gitea-mcp 设计](../Obsidian%20Vault/Coding/gitea-mcp/gitea-mcp%20设计.md)
|
||||||
|
- [MCP 实现指南](../Obsidian%20Vault/Coding/obsidian-mcp/MCP%20实现指南.md)
|
||||||
|
- [nas-auth 设计](../Obsidian%20Vault/Coding/nas-auth/nas-auth%20设计.md)
|
||||||
|
- [Gitea Actions Build-Deploy 模板](../Obsidian%20Vault/Coding/Gitea%20Actions%20Build-Deploy%20模板.md)
|
||||||
@@ -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; }
|
||||||
|
}
|
||||||
@@ -0,0 +1,108 @@
|
|||||||
|
using GiteaMcp.Services;
|
||||||
|
using ModelContextProtocol.Server;
|
||||||
|
using System.ComponentModel;
|
||||||
|
|
||||||
|
namespace GiteaMcp.Tools;
|
||||||
|
|
||||||
|
/// <summary>Gitea Actions Tool：list_workflow_runs / read_run_log</summary>
|
||||||
|
[McpServerToolType]
|
||||||
|
public class ActionsTools(
|
||||||
|
GiteaApiClient gitea,
|
||||||
|
GiteaRepoFilter filter)
|
||||||
|
{
|
||||||
|
[McpServerTool]
|
||||||
|
[Description(
|
||||||
|
"List recent Gitea Actions workflow runs for a repository. " +
|
||||||
|
"Filter by branch name or run status (queued/in_progress/success/failure/cancelled/skipped). " +
|
||||||
|
"Returns: run ID, workflow name, triggering event, branch, status, conclusion, actor, and timestamps. " +
|
||||||
|
"Use read_run_log to get the full log output of a specific run or job.")]
|
||||||
|
public async Task<object> list_workflow_runs(
|
||||||
|
[Description("Repository owner.")] string owner,
|
||||||
|
[Description("Repository name.")] string repo,
|
||||||
|
[Description("Filter by branch name. Optional.")] string? branch = null,
|
||||||
|
[Description("Filter by status: 'queued', 'in_progress', 'success', 'failure', 'cancelled', 'skipped'. Optional.")] string? status = null,
|
||||||
|
[Description("Max runs to return. Default 30.")] int? limit = null,
|
||||||
|
CancellationToken ct = default)
|
||||||
|
{
|
||||||
|
if (filter.IsBlocked($"{owner}/{repo}"))
|
||||||
|
throw new UnauthorizedAccessException($"Repo {owner}/{repo} is on the access blocklist.");
|
||||||
|
|
||||||
|
var lim = Math.Min(limit ?? 30, 100);
|
||||||
|
var result = await gitea.GetWorkflowRunsAsync(owner, repo, branch, status, lim, ct);
|
||||||
|
|
||||||
|
return new
|
||||||
|
{
|
||||||
|
total = result.TotalCount,
|
||||||
|
runs = result.WorkflowRuns.Select(r => new
|
||||||
|
{
|
||||||
|
id = r.Id,
|
||||||
|
name = r.Name,
|
||||||
|
@event = r.Event,
|
||||||
|
branch = r.HeadBranch,
|
||||||
|
sha = r.HeadSha,
|
||||||
|
status = r.Status,
|
||||||
|
conclusion = r.Conclusion,
|
||||||
|
actor = r.Actor?.Login,
|
||||||
|
html_url = r.HtmlUrl,
|
||||||
|
created_at = r.CreatedAt,
|
||||||
|
updated_at = r.UpdatedAt,
|
||||||
|
}).ToList(),
|
||||||
|
};
|
||||||
|
}
|
||||||
|
|
||||||
|
[McpServerTool]
|
||||||
|
[Description(
|
||||||
|
"Get detailed info and log output for a specific Gitea Actions workflow run. " +
|
||||||
|
"Returns: run overview (status, conclusion, timing) + all jobs with their status. " +
|
||||||
|
"Log output is truncated to 1MB; long logs will have '[...log truncated...]' appended. " +
|
||||||
|
"When job_id is provided, fetches that specific job's log; otherwise fetches the run-level log. " +
|
||||||
|
"Use list_workflow_runs to find the run_id.")]
|
||||||
|
public async Task<object> read_run_log(
|
||||||
|
[Description("Repository owner.")] string owner,
|
||||||
|
[Description("Repository name.")] string repo,
|
||||||
|
[Description("Workflow run ID (from list_workflow_runs).")] long run_id,
|
||||||
|
[Description("Specific job ID to fetch logs for. Omit to get the run-level log.")] long? job_id = null,
|
||||||
|
CancellationToken ct = default)
|
||||||
|
{
|
||||||
|
if (filter.IsBlocked($"{owner}/{repo}"))
|
||||||
|
throw new UnauthorizedAccessException($"Repo {owner}/{repo} is on the access blocklist.");
|
||||||
|
|
||||||
|
var runTask = gitea.GetWorkflowRunAsync(owner, repo, run_id, ct);
|
||||||
|
var jobsTask = gitea.GetRunJobsAsync(owner, repo, run_id, ct);
|
||||||
|
var logTask = gitea.GetRunLogAsync(owner, repo, run_id, job_id, ct: ct);
|
||||||
|
|
||||||
|
await Task.WhenAll(runTask, jobsTask, logTask);
|
||||||
|
|
||||||
|
var run = await runTask;
|
||||||
|
var jobList = await jobsTask;
|
||||||
|
var log = await logTask;
|
||||||
|
|
||||||
|
return new
|
||||||
|
{
|
||||||
|
run = new
|
||||||
|
{
|
||||||
|
id = run.Id,
|
||||||
|
name = run.Name,
|
||||||
|
@event = run.Event,
|
||||||
|
branch = run.HeadBranch,
|
||||||
|
sha = run.HeadSha,
|
||||||
|
status = run.Status,
|
||||||
|
conclusion = run.Conclusion,
|
||||||
|
actor = run.Actor?.Login,
|
||||||
|
html_url = run.HtmlUrl,
|
||||||
|
created_at = run.CreatedAt,
|
||||||
|
updated_at = run.UpdatedAt,
|
||||||
|
},
|
||||||
|
jobs = jobList.WorkflowJobs.Select(j => new
|
||||||
|
{
|
||||||
|
id = j.Id,
|
||||||
|
name = j.Name,
|
||||||
|
status = j.Status,
|
||||||
|
conclusion = j.Conclusion,
|
||||||
|
started_at = j.StartedAt,
|
||||||
|
completed_at = j.CompletedAt,
|
||||||
|
}).ToList(),
|
||||||
|
log,
|
||||||
|
};
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,121 @@
|
|||||||
|
using GiteaMcp.Services;
|
||||||
|
using ModelContextProtocol.Server;
|
||||||
|
using System.ComponentModel;
|
||||||
|
|
||||||
|
namespace GiteaMcp.Tools;
|
||||||
|
|
||||||
|
/// <summary>分支与 commit Tool：list_branches / list_commits / read_commit</summary>
|
||||||
|
[McpServerToolType]
|
||||||
|
public class BranchCommitTools(
|
||||||
|
GiteaApiClient gitea,
|
||||||
|
GiteaRepoFilter filter)
|
||||||
|
{
|
||||||
|
[McpServerTool]
|
||||||
|
[Description(
|
||||||
|
"List all branches in a Gitea repository with their latest commit info. " +
|
||||||
|
"Returns: branch name, protected flag, last commit SHA, message, timestamp, and author. " +
|
||||||
|
"Use this to discover available branches before calling list_commits or read_file with a specific ref.")]
|
||||||
|
public async Task<object> list_branches(
|
||||||
|
[Description("Repository owner.")] string owner,
|
||||||
|
[Description("Repository name.")] string repo,
|
||||||
|
CancellationToken ct = default)
|
||||||
|
{
|
||||||
|
if (filter.IsBlocked($"{owner}/{repo}"))
|
||||||
|
throw new UnauthorizedAccessException($"Repo {owner}/{repo} is on the access blocklist.");
|
||||||
|
|
||||||
|
var branches = await gitea.GetBranchesAsync(owner, repo, ct);
|
||||||
|
return branches.Select(b => new
|
||||||
|
{
|
||||||
|
name = b.Name,
|
||||||
|
@protected = b.Protected,
|
||||||
|
last_commit = b.Commit == null ? null : new
|
||||||
|
{
|
||||||
|
sha = b.Commit.Id,
|
||||||
|
message = b.Commit.Message,
|
||||||
|
timestamp = b.Commit.Timestamp,
|
||||||
|
author = b.Commit.Author?.Name,
|
||||||
|
},
|
||||||
|
}).ToList();
|
||||||
|
}
|
||||||
|
|
||||||
|
[McpServerTool]
|
||||||
|
[Description(
|
||||||
|
"List recent commits in a Gitea repository. " +
|
||||||
|
"Returns: SHA (short+full), commit message, author, and timestamp. " +
|
||||||
|
"Use ref to specify a branch or tag; use since (ISO 8601 date) to filter by date. " +
|
||||||
|
"Default returns up to 30 commits. Good for 'what changed recently' questions.")]
|
||||||
|
public async Task<object> list_commits(
|
||||||
|
[Description("Repository owner.")] string owner,
|
||||||
|
[Description("Repository name.")] string repo,
|
||||||
|
[Description("Branch, tag, or SHA. Defaults to the default branch.")] string? @ref = null,
|
||||||
|
[Description("Only commits after this date (ISO 8601, e.g. '2026-04-01T00:00:00Z'). Optional.")] string? since = null,
|
||||||
|
[Description("Max commits to return. Default 30.")] int? limit = null,
|
||||||
|
CancellationToken ct = default)
|
||||||
|
{
|
||||||
|
if (filter.IsBlocked($"{owner}/{repo}"))
|
||||||
|
throw new UnauthorizedAccessException($"Repo {owner}/{repo} is on the access blocklist.");
|
||||||
|
|
||||||
|
var lim = Math.Min(limit ?? 30, 100);
|
||||||
|
var commits = await gitea.GetCommitsAsync(owner, repo, @ref, since, lim, ct);
|
||||||
|
|
||||||
|
return commits.Select(c => new
|
||||||
|
{
|
||||||
|
sha = c.Sha,
|
||||||
|
sha_short = c.Sha.Length >= 8 ? c.Sha[..8] : c.Sha,
|
||||||
|
message = c.Commit?.Message,
|
||||||
|
author = c.Commit?.Author?.Name,
|
||||||
|
author_email = c.Commit?.Author?.Email,
|
||||||
|
timestamp = c.Commit?.Author?.Date ?? c.Created,
|
||||||
|
}).ToList();
|
||||||
|
}
|
||||||
|
|
||||||
|
[McpServerTool]
|
||||||
|
[Description(
|
||||||
|
"Get full details of a single commit: message, author, stats, and per-file diff. " +
|
||||||
|
"Files are limited to max_files=50; when truncated=true, some files are omitted. " +
|
||||||
|
"Patch (diff text) is included per file — useful for code review or understanding specific changes. " +
|
||||||
|
"Use list_commits first to obtain a SHA.")]
|
||||||
|
public async Task<object> read_commit(
|
||||||
|
[Description("Repository owner.")] string owner,
|
||||||
|
[Description("Repository name.")] string repo,
|
||||||
|
[Description("Full or abbreviated commit SHA.")] string sha,
|
||||||
|
CancellationToken ct = default)
|
||||||
|
{
|
||||||
|
if (filter.IsBlocked($"{owner}/{repo}"))
|
||||||
|
throw new UnauthorizedAccessException($"Repo {owner}/{repo} is on the access blocklist.");
|
||||||
|
|
||||||
|
const int MaxFiles = 50;
|
||||||
|
var commit = await gitea.GetCommitAsync(owner, repo, sha, ct);
|
||||||
|
|
||||||
|
var files = commit.Files ?? [];
|
||||||
|
bool truncated = files.Count > MaxFiles;
|
||||||
|
if (truncated) files = files.Take(MaxFiles).ToList();
|
||||||
|
|
||||||
|
return new
|
||||||
|
{
|
||||||
|
sha = commit.Sha,
|
||||||
|
message = commit.Commit?.Message,
|
||||||
|
author = commit.Commit?.Author?.Name,
|
||||||
|
author_email = commit.Commit?.Author?.Email,
|
||||||
|
authored_at = commit.Commit?.Author?.Date,
|
||||||
|
committer = commit.Commit?.Committer?.Name,
|
||||||
|
committed_at = commit.Commit?.Committer?.Date ?? commit.Created,
|
||||||
|
stats = commit.Stats == null ? null : new
|
||||||
|
{
|
||||||
|
total = commit.Stats.Total,
|
||||||
|
additions = commit.Stats.Additions,
|
||||||
|
deletions = commit.Stats.Deletions,
|
||||||
|
},
|
||||||
|
files_truncated = truncated,
|
||||||
|
files = files.Select(f => new
|
||||||
|
{
|
||||||
|
filename = f.Filename,
|
||||||
|
status = f.Status,
|
||||||
|
additions = f.Additions,
|
||||||
|
deletions = f.Deletions,
|
||||||
|
changes = f.Changes,
|
||||||
|
patch = f.Patch,
|
||||||
|
}).ToList(),
|
||||||
|
};
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,89 @@
|
|||||||
|
using GiteaMcp.Services;
|
||||||
|
using ModelContextProtocol.Server;
|
||||||
|
using System.ComponentModel;
|
||||||
|
|
||||||
|
namespace GiteaMcp.Tools;
|
||||||
|
|
||||||
|
/// <summary>Issue Tool：list_issues / read_issue</summary>
|
||||||
|
[McpServerToolType]
|
||||||
|
public class IssueTools(
|
||||||
|
GiteaApiClient gitea,
|
||||||
|
GiteaRepoFilter filter)
|
||||||
|
{
|
||||||
|
[McpServerTool]
|
||||||
|
[Description(
|
||||||
|
"List issues in a Gitea repository. " +
|
||||||
|
"state can be 'open' (default), 'closed', or 'all'. " +
|
||||||
|
"Returns: issue number, title, state, labels, assignees, created_at, comment count, and URL. " +
|
||||||
|
"Use read_issue to get the full body and comments of a specific issue.")]
|
||||||
|
public async Task<object> list_issues(
|
||||||
|
[Description("Repository owner.")] string owner,
|
||||||
|
[Description("Repository name.")] string repo,
|
||||||
|
[Description("Filter by state: 'open', 'closed', or 'all'. Default 'open'.")] string? state = null,
|
||||||
|
[Description("Max issues to return. Default 30.")] int? limit = null,
|
||||||
|
CancellationToken ct = default)
|
||||||
|
{
|
||||||
|
if (filter.IsBlocked($"{owner}/{repo}"))
|
||||||
|
throw new UnauthorizedAccessException($"Repo {owner}/{repo} is on the access blocklist.");
|
||||||
|
|
||||||
|
var st = state ?? "open";
|
||||||
|
var lim = Math.Min(limit ?? 30, 50);
|
||||||
|
var issues = await gitea.GetIssuesAsync(owner, repo, st, lim, ct);
|
||||||
|
|
||||||
|
return issues.Select(i => new
|
||||||
|
{
|
||||||
|
number = i.Number,
|
||||||
|
title = i.Title,
|
||||||
|
state = i.State,
|
||||||
|
html_url = i.HtmlUrl,
|
||||||
|
author = i.User?.Login,
|
||||||
|
labels = i.Labels?.Select(l => l.Name).ToList() ?? [],
|
||||||
|
assignees = i.Assignees?.Select(a => a.Login).ToList() ?? [],
|
||||||
|
comments = i.Comments,
|
||||||
|
created_at = i.CreatedAt,
|
||||||
|
updated_at = i.UpdatedAt,
|
||||||
|
closed_at = i.ClosedAt,
|
||||||
|
}).ToList();
|
||||||
|
}
|
||||||
|
|
||||||
|
[McpServerTool]
|
||||||
|
[Description(
|
||||||
|
"Get the full body and all comments of a specific Gitea issue. " +
|
||||||
|
"Use list_issues first to find the issue number. " +
|
||||||
|
"Returns: title, body (Markdown), state, labels, and all comment texts with authors and timestamps.")]
|
||||||
|
public async Task<object> read_issue(
|
||||||
|
[Description("Repository owner.")] string owner,
|
||||||
|
[Description("Repository name.")] string repo,
|
||||||
|
[Description("Issue number (integer, e.g. 42).")] int number,
|
||||||
|
CancellationToken ct = default)
|
||||||
|
{
|
||||||
|
if (filter.IsBlocked($"{owner}/{repo}"))
|
||||||
|
throw new UnauthorizedAccessException($"Repo {owner}/{repo} is on the access blocklist.");
|
||||||
|
|
||||||
|
var issue = await gitea.GetIssueAsync(owner, repo, number, ct);
|
||||||
|
var comments = await gitea.GetIssueCommentsAsync(owner, repo, number, ct);
|
||||||
|
|
||||||
|
return new
|
||||||
|
{
|
||||||
|
number = issue.Number,
|
||||||
|
title = issue.Title,
|
||||||
|
body = issue.Body,
|
||||||
|
state = issue.State,
|
||||||
|
html_url = issue.HtmlUrl,
|
||||||
|
author = issue.User?.Login,
|
||||||
|
labels = issue.Labels?.Select(l => l.Name).ToList() ?? [],
|
||||||
|
assignees = issue.Assignees?.Select(a => a.Login).ToList() ?? [],
|
||||||
|
created_at = issue.CreatedAt,
|
||||||
|
updated_at = issue.UpdatedAt,
|
||||||
|
closed_at = issue.ClosedAt,
|
||||||
|
comments = comments.Select(c => new
|
||||||
|
{
|
||||||
|
id = c.Id,
|
||||||
|
author = c.User?.Login,
|
||||||
|
body = c.Body,
|
||||||
|
created_at = c.CreatedAt,
|
||||||
|
updated_at = c.UpdatedAt,
|
||||||
|
}).ToList(),
|
||||||
|
};
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,56 @@
|
|||||||
|
using GiteaMcp.Services;
|
||||||
|
using ModelContextProtocol.Server;
|
||||||
|
using System.ComponentModel;
|
||||||
|
|
||||||
|
namespace GiteaMcp.Tools;
|
||||||
|
|
||||||
|
/// <summary>Organization Tool：list_orgs / read_org</summary>
|
||||||
|
[McpServerToolType]
|
||||||
|
public class OrgTools(GiteaApiClient gitea)
|
||||||
|
{
|
||||||
|
[McpServerTool]
|
||||||
|
[Description(
|
||||||
|
"List all Gitea organizations visible to the admin token. " +
|
||||||
|
"Returns: org name, full name, description, visibility, and website. " +
|
||||||
|
"Use read_org to get repo/member counts for a specific org. " +
|
||||||
|
"Tip: after listing orgs, call list_repos with owner=<org_name> to see that org's repos.")]
|
||||||
|
public async Task<object> list_orgs(
|
||||||
|
[Description("Max orgs to return. Default 50.")] int? limit = null,
|
||||||
|
CancellationToken ct = default)
|
||||||
|
{
|
||||||
|
var lim = Math.Min(limit ?? 50, 50);
|
||||||
|
var orgs = await gitea.GetOrgsAsync(lim, ct);
|
||||||
|
|
||||||
|
return orgs.Select(o => new
|
||||||
|
{
|
||||||
|
name = o.Name,
|
||||||
|
full_name = o.FullName,
|
||||||
|
description = o.Description,
|
||||||
|
website = o.Website,
|
||||||
|
location = o.Location,
|
||||||
|
visibility = o.Visibility,
|
||||||
|
}).ToList();
|
||||||
|
}
|
||||||
|
|
||||||
|
[McpServerTool]
|
||||||
|
[Description(
|
||||||
|
"Get detailed information about a specific Gitea organization: " +
|
||||||
|
"description, website, location, and visibility setting. " +
|
||||||
|
"Use list_repos with owner=<name> to see the org's repositories.")]
|
||||||
|
public async Task<object> read_org(
|
||||||
|
[Description("Organization name (login).")] string name,
|
||||||
|
CancellationToken ct = default)
|
||||||
|
{
|
||||||
|
var org = await gitea.GetOrgAsync(name, ct);
|
||||||
|
|
||||||
|
return new
|
||||||
|
{
|
||||||
|
name = org.Name,
|
||||||
|
full_name = org.FullName,
|
||||||
|
description = org.Description,
|
||||||
|
website = org.Website,
|
||||||
|
location = org.Location,
|
||||||
|
visibility = org.Visibility,
|
||||||
|
};
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,61 @@
|
|||||||
|
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,
|
||||||
|
};
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,110 @@
|
|||||||
|
using GiteaMcp.Services;
|
||||||
|
using ModelContextProtocol.Server;
|
||||||
|
using System.ComponentModel;
|
||||||
|
|
||||||
|
namespace GiteaMcp.Tools;
|
||||||
|
|
||||||
|
/// <summary>Pull Request Tool：list_pulls / read_pull</summary>
|
||||||
|
[McpServerToolType]
|
||||||
|
public class PullTools(
|
||||||
|
GiteaApiClient gitea,
|
||||||
|
GiteaRepoFilter filter)
|
||||||
|
{
|
||||||
|
[McpServerTool]
|
||||||
|
[Description(
|
||||||
|
"List pull requests in a Gitea repository. " +
|
||||||
|
"state: 'open' (default), 'closed', or 'all'. " +
|
||||||
|
"Returns: PR number, title, state, head/base branches, merged status, labels, and URL. " +
|
||||||
|
"Use read_pull to get the full body, review comments, and changed files list.")]
|
||||||
|
public async Task<object> list_pulls(
|
||||||
|
[Description("Repository owner.")] string owner,
|
||||||
|
[Description("Repository name.")] string repo,
|
||||||
|
[Description("Filter by state: 'open', 'closed', or 'all'. Default 'open'.")] string? state = null,
|
||||||
|
[Description("Max PRs to return. Default 30.")] int? limit = null,
|
||||||
|
CancellationToken ct = default)
|
||||||
|
{
|
||||||
|
if (filter.IsBlocked($"{owner}/{repo}"))
|
||||||
|
throw new UnauthorizedAccessException($"Repo {owner}/{repo} is on the access blocklist.");
|
||||||
|
|
||||||
|
var st = state ?? "open";
|
||||||
|
var lim = Math.Min(limit ?? 30, 50);
|
||||||
|
var pulls = await gitea.GetPullsAsync(owner, repo, st, lim, ct);
|
||||||
|
|
||||||
|
return pulls.Select(p => new
|
||||||
|
{
|
||||||
|
number = p.Number,
|
||||||
|
title = p.Title,
|
||||||
|
state = p.State,
|
||||||
|
html_url = p.HtmlUrl,
|
||||||
|
author = p.User?.Login,
|
||||||
|
head = p.Head?.Ref,
|
||||||
|
base_branch = p.Base?.Ref,
|
||||||
|
merged = p.Merged,
|
||||||
|
labels = p.Labels?.Select(l => l.Name).ToList() ?? [],
|
||||||
|
created_at = p.CreatedAt,
|
||||||
|
updated_at = p.UpdatedAt,
|
||||||
|
merged_at = p.MergedAt,
|
||||||
|
}).ToList();
|
||||||
|
}
|
||||||
|
|
||||||
|
[McpServerTool]
|
||||||
|
[Description(
|
||||||
|
"Get full details of a specific pull request: body, review comments, and list of changed files. " +
|
||||||
|
"Changed files include filename, status (added/modified/removed), and line counts. " +
|
||||||
|
"Use list_pulls first to find the PR number.")]
|
||||||
|
public async Task<object> read_pull(
|
||||||
|
[Description("Repository owner.")] string owner,
|
||||||
|
[Description("Repository name.")] string repo,
|
||||||
|
[Description("Pull request number (integer).")] int number,
|
||||||
|
CancellationToken ct = default)
|
||||||
|
{
|
||||||
|
if (filter.IsBlocked($"{owner}/{repo}"))
|
||||||
|
throw new UnauthorizedAccessException($"Repo {owner}/{repo} is on the access blocklist.");
|
||||||
|
|
||||||
|
// 并行拉取 PR 主体、评论、变更文件
|
||||||
|
var pullTask = gitea.GetPullAsync(owner, repo, number, ct);
|
||||||
|
var commentsTask = gitea.GetPullCommentsAsync(owner, repo, number, ct);
|
||||||
|
var filesTask = gitea.GetPullFilesAsync(owner, repo, number, ct);
|
||||||
|
|
||||||
|
await Task.WhenAll(pullTask, commentsTask, filesTask);
|
||||||
|
|
||||||
|
var pull = await pullTask;
|
||||||
|
var comments = await commentsTask;
|
||||||
|
var files = await filesTask;
|
||||||
|
|
||||||
|
return new
|
||||||
|
{
|
||||||
|
number = pull.Number,
|
||||||
|
title = pull.Title,
|
||||||
|
body = pull.Body,
|
||||||
|
state = pull.State,
|
||||||
|
html_url = pull.HtmlUrl,
|
||||||
|
author = pull.User?.Login,
|
||||||
|
head = pull.Head?.Ref,
|
||||||
|
head_sha = pull.Head?.Sha,
|
||||||
|
base_branch = pull.Base?.Ref,
|
||||||
|
merged = pull.Merged,
|
||||||
|
mergeable = pull.Mergeable,
|
||||||
|
labels = pull.Labels?.Select(l => l.Name).ToList() ?? [],
|
||||||
|
created_at = pull.CreatedAt,
|
||||||
|
updated_at = pull.UpdatedAt,
|
||||||
|
closed_at = pull.ClosedAt,
|
||||||
|
merged_at = pull.MergedAt,
|
||||||
|
comments = comments.Select(c => new
|
||||||
|
{
|
||||||
|
id = c.Id,
|
||||||
|
author = c.User?.Login,
|
||||||
|
body = c.Body,
|
||||||
|
created_at = c.CreatedAt,
|
||||||
|
}).ToList(),
|
||||||
|
changed_files = files.Select(f => new
|
||||||
|
{
|
||||||
|
filename = f.Filename,
|
||||||
|
status = f.Status,
|
||||||
|
additions = f.Additions,
|
||||||
|
deletions = f.Deletions,
|
||||||
|
changes = f.Changes,
|
||||||
|
}).ToList(),
|
||||||
|
};
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,89 @@
|
|||||||
|
using GiteaMcp.Config;
|
||||||
|
using GiteaMcp.Services;
|
||||||
|
using GiteaMcp.Services.Models;
|
||||||
|
using Microsoft.Extensions.Options;
|
||||||
|
using ModelContextProtocol.Server;
|
||||||
|
using System.ComponentModel;
|
||||||
|
|
||||||
|
namespace GiteaMcp.Tools;
|
||||||
|
|
||||||
|
/// <summary>仓库级别 Tool：list_repos / read_repo</summary>
|
||||||
|
[McpServerToolType]
|
||||||
|
public class RepoTools(
|
||||||
|
GiteaApiClient gitea,
|
||||||
|
GiteaRepoFilter filter,
|
||||||
|
IOptions<GiteaOptions> opts)
|
||||||
|
{
|
||||||
|
private readonly GiteaOptions _opts = opts.Value;
|
||||||
|
|
||||||
|
[McpServerTool]
|
||||||
|
[Description(
|
||||||
|
"List Gitea repositories accessible to the admin token. " +
|
||||||
|
"When owner is omitted, returns ALL repos across personal account and all orgs (up to limit). " +
|
||||||
|
"Use visibility='private' to show only private repos, 'public' for public-only. " +
|
||||||
|
"Returns: owner, repo name, description, default_branch, private flag, size (KB), updated_at, html_url. " +
|
||||||
|
"Tip: call this first to discover available repos before using read_repo or read_file.")]
|
||||||
|
public async Task<List<object>> list_repos(
|
||||||
|
[Description("Filter by owner login (user or org name). Omit to list everything.")] string? owner = null,
|
||||||
|
[Description("Visibility filter: 'public', 'private', or 'all' (default 'all').")] string? visibility = null,
|
||||||
|
[Description("Max number of repos to return. Default 50, max 50.")] int? limit = null,
|
||||||
|
CancellationToken ct = default)
|
||||||
|
{
|
||||||
|
var vis = visibility ?? "all";
|
||||||
|
var lim = Math.Min(limit ?? _opts.DefaultLimit, 50);
|
||||||
|
|
||||||
|
var repos = await gitea.SearchReposAsync(owner, vis, lim, ct);
|
||||||
|
repos = filter.Filter(repos);
|
||||||
|
|
||||||
|
return repos.Select(r => (object)new
|
||||||
|
{
|
||||||
|
owner = r.Owner?.Login ?? r.FullName.Split('/').FirstOrDefault() ?? "",
|
||||||
|
repo = r.Name,
|
||||||
|
full_name = r.FullName,
|
||||||
|
description = r.Description,
|
||||||
|
default_branch = r.DefaultBranch,
|
||||||
|
@private = r.Private,
|
||||||
|
mirror = r.Mirror,
|
||||||
|
archived = r.Archived,
|
||||||
|
size_kb = r.Size,
|
||||||
|
updated_at = r.UpdatedAt,
|
||||||
|
html_url = r.HtmlUrl,
|
||||||
|
}).ToList();
|
||||||
|
}
|
||||||
|
|
||||||
|
[McpServerTool]
|
||||||
|
[Description(
|
||||||
|
"Get detailed metadata for a single Gitea repository: topics, homepage, default branch, " +
|
||||||
|
"stars, forks, archived status, mirror flag, size, and description. " +
|
||||||
|
"Use this after list_repos to inspect a specific repo before reading files or commits.")]
|
||||||
|
public async Task<object> read_repo(
|
||||||
|
[Description("Repository owner (user login or org name).")] string owner,
|
||||||
|
[Description("Repository name (without owner prefix).")] string repo,
|
||||||
|
CancellationToken ct = default)
|
||||||
|
{
|
||||||
|
if (filter.IsBlocked($"{owner}/{repo}"))
|
||||||
|
throw new UnauthorizedAccessException($"Repo {owner}/{repo} is on the access blocklist.");
|
||||||
|
|
||||||
|
var r = await gitea.GetRepoAsync(owner, repo, ct);
|
||||||
|
return new
|
||||||
|
{
|
||||||
|
owner = r.Owner?.Login ?? owner,
|
||||||
|
repo = r.Name,
|
||||||
|
full_name = r.FullName,
|
||||||
|
description = r.Description,
|
||||||
|
default_branch = r.DefaultBranch,
|
||||||
|
@private = r.Private,
|
||||||
|
fork = r.Fork,
|
||||||
|
mirror = r.Mirror,
|
||||||
|
archived = r.Archived,
|
||||||
|
stars = r.StarsCount,
|
||||||
|
forks = r.ForksCount,
|
||||||
|
size_kb = r.Size,
|
||||||
|
website = r.Website,
|
||||||
|
topics = r.Topics ?? [],
|
||||||
|
html_url = r.HtmlUrl,
|
||||||
|
clone_url = r.CloneUrl,
|
||||||
|
updated_at = r.UpdatedAt,
|
||||||
|
};
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,75 @@
|
|||||||
|
using GiteaMcp.Services;
|
||||||
|
using GiteaMcp.Services.Models;
|
||||||
|
using ModelContextProtocol.Server;
|
||||||
|
using System.ComponentModel;
|
||||||
|
|
||||||
|
namespace GiteaMcp.Tools;
|
||||||
|
|
||||||
|
/// <summary>代码搜索 Tool：search_code</summary>
|
||||||
|
[McpServerToolType]
|
||||||
|
public class SearchTools(
|
||||||
|
GiteaApiClient gitea,
|
||||||
|
GiteaRepoFilter filter)
|
||||||
|
{
|
||||||
|
[McpServerTool]
|
||||||
|
[Description(
|
||||||
|
"Search code across Gitea repositories using Gitea's built-in code indexer. " +
|
||||||
|
"Requires Gitea to have REPO_INDEXER_ENABLED=true in app.ini. " +
|
||||||
|
"If the indexer is not enabled, returns an explanatory error instead of silently returning empty. " +
|
||||||
|
"Scope: when owner+repo are provided, searches only that repo; otherwise searches all accessible repos. " +
|
||||||
|
"Returns: owner, repo, file path, line number, and a preview snippet of the matching line. " +
|
||||||
|
"Limit: max 50 results. For large codebases, narrow with owner or repo.")]
|
||||||
|
public async Task<object> search_code(
|
||||||
|
[Description("Search query string. Supports keywords; no regex.")] string query,
|
||||||
|
[Description("Restrict search to this owner (user login or org name). Optional.")] string? owner = null,
|
||||||
|
[Description("Restrict search to this repo name (requires owner). Optional.")] string? repo = null,
|
||||||
|
[Description("Max number of results. Default 50.")] int? limit = null,
|
||||||
|
CancellationToken ct = default)
|
||||||
|
{
|
||||||
|
var lim = Math.Min(limit ?? 50, 50);
|
||||||
|
|
||||||
|
// 检查是否需要过滤黑名单
|
||||||
|
if (!string.IsNullOrWhiteSpace(owner) && !string.IsNullOrWhiteSpace(repo)
|
||||||
|
&& filter.IsBlocked($"{owner}/{repo}"))
|
||||||
|
{
|
||||||
|
throw new UnauthorizedAccessException($"Repo {owner}/{repo} is on the access blocklist.");
|
||||||
|
}
|
||||||
|
|
||||||
|
// 调 Gitea code search 端点（仅在 [indexer] REPO_INDEXER_ENABLED=true 时可用）。
|
||||||
|
// indexer 未启用 → API 返回 404，GiteaApiClient.EnsureSuccessAsync 抛 KeyNotFoundException，
|
||||||
|
// 这里捕获后返回结构化降级提示，避免 swallow 到空数组让 Claude 误以为"搜不到"。
|
||||||
|
try
|
||||||
|
{
|
||||||
|
var codeResult = await gitea.SearchCodeAsync(query, owner, repo, lim, ct);
|
||||||
|
|
||||||
|
var hits = codeResult.Data
|
||||||
|
.Where(d => d.Repo == null || !filter.IsBlocked(d.Repo.FullName))
|
||||||
|
.Take(lim)
|
||||||
|
.Select(d => (object)new
|
||||||
|
{
|
||||||
|
owner = d.Repo?.Owner?.Login ?? "",
|
||||||
|
repo = d.Repo?.Name ?? "",
|
||||||
|
path = d.Filename,
|
||||||
|
// Gitea code search 不返回精确行号，前端可在 preview 里自行定位
|
||||||
|
line = 0,
|
||||||
|
preview = d.Content?.Length > 200 ? d.Content[..200] + "..." : d.Content ?? "",
|
||||||
|
})
|
||||||
|
.ToList();
|
||||||
|
|
||||||
|
return new { ok = true, results = hits };
|
||||||
|
}
|
||||||
|
catch (KeyNotFoundException)
|
||||||
|
{
|
||||||
|
// indexer 未启用 → 404；返回结构化提示，不要 swallow 成空 results
|
||||||
|
return new
|
||||||
|
{
|
||||||
|
ok = false,
|
||||||
|
error = "indexer_disabled",
|
||||||
|
notice = "Gitea code search endpoint returned 404. " +
|
||||||
|
"Enable the code indexer by setting [indexer] REPO_INDEXER_ENABLED=true in app.ini and restart Gitea. " +
|
||||||
|
"Workaround: use list_tree + read_file to navigate files manually.",
|
||||||
|
results = Array.Empty<object>(),
|
||||||
|
};
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,104 @@
|
|||||||
|
using GiteaMcp.Config;
|
||||||
|
using GiteaMcp.Services;
|
||||||
|
using GiteaMcp.Services.Models;
|
||||||
|
using Microsoft.Extensions.Options;
|
||||||
|
using ModelContextProtocol.Server;
|
||||||
|
using System.ComponentModel;
|
||||||
|
|
||||||
|
namespace GiteaMcp.Tools;
|
||||||
|
|
||||||
|
/// <summary>文件树与文件内容 Tool：list_tree / read_file</summary>
|
||||||
|
[McpServerToolType]
|
||||||
|
public class TreeTools(
|
||||||
|
GiteaApiClient gitea,
|
||||||
|
GiteaRepoFilter filter,
|
||||||
|
IOptions<GiteaOptions> opts)
|
||||||
|
{
|
||||||
|
private readonly GiteaOptions _opts = opts.Value;
|
||||||
|
|
||||||
|
[McpServerTool]
|
||||||
|
[Description(
|
||||||
|
"List the file tree of a Gitea repository at a given ref (branch/tag/SHA). " +
|
||||||
|
"When recursive=false (default), returns only top-level entries. " +
|
||||||
|
"When recursive=true, returns all files up to max_entries=500 — use this to map repo structure. " +
|
||||||
|
"Returns: path, type ('blob'=file, 'tree'=directory), size (bytes), sha. " +
|
||||||
|
"For very large repos (>500 files), truncated=true will be set; narrow down by adjusting paths manually.")]
|
||||||
|
public async Task<object> list_tree(
|
||||||
|
[Description("Repository owner.")] string owner,
|
||||||
|
[Description("Repository name.")] string repo,
|
||||||
|
[Description("Branch name, tag, or commit SHA. Defaults to the repo's default branch.")] string? @ref = null,
|
||||||
|
[Description("Recursively include all files in subdirectories. Default false.")] bool recursive = false,
|
||||||
|
CancellationToken ct = default)
|
||||||
|
{
|
||||||
|
if (filter.IsBlocked($"{owner}/{repo}"))
|
||||||
|
throw new UnauthorizedAccessException($"Repo {owner}/{repo} is on the access blocklist.");
|
||||||
|
|
||||||
|
// ref 未提供时，先拿 default_branch
|
||||||
|
if (string.IsNullOrWhiteSpace(@ref))
|
||||||
|
{
|
||||||
|
var repoMeta = await gitea.GetRepoAsync(owner, repo, ct);
|
||||||
|
@ref = repoMeta.DefaultBranch;
|
||||||
|
}
|
||||||
|
|
||||||
|
var tree = await gitea.GetTreeAsync(owner, repo, @ref, recursive, ct);
|
||||||
|
|
||||||
|
const int MaxEntries = 500;
|
||||||
|
var entries = tree.Tree;
|
||||||
|
bool truncated = tree.Truncated || entries.Count > MaxEntries;
|
||||||
|
if (entries.Count > MaxEntries)
|
||||||
|
entries = entries.Take(MaxEntries).ToList();
|
||||||
|
|
||||||
|
return new
|
||||||
|
{
|
||||||
|
owner,
|
||||||
|
repo,
|
||||||
|
@ref,
|
||||||
|
truncated,
|
||||||
|
entry_count = entries.Count,
|
||||||
|
entries = entries.Select(e => new
|
||||||
|
{
|
||||||
|
path = e.Path,
|
||||||
|
type = e.Type,
|
||||||
|
size = e.Size,
|
||||||
|
sha = e.Sha,
|
||||||
|
}),
|
||||||
|
};
|
||||||
|
}
|
||||||
|
|
||||||
|
[McpServerTool]
|
||||||
|
[Description(
|
||||||
|
"Read the raw text content of a file from a Gitea repository. " +
|
||||||
|
"Returns the file as UTF-8 text. Binary files will appear garbled — check file extension first. " +
|
||||||
|
"Truncated to max_bytes (default 1MB); when truncated=true, the content is cut off. " +
|
||||||
|
"Use list_tree first to discover file paths.")]
|
||||||
|
public async Task<object> read_file(
|
||||||
|
[Description("Repository owner.")] string owner,
|
||||||
|
[Description("Repository name.")] string repo,
|
||||||
|
[Description("File path relative to repo root, e.g. 'src/Main.cs' or 'README.md'.")] string path,
|
||||||
|
[Description("Branch, tag, or SHA. Defaults to repo's default branch.")] string? @ref = null,
|
||||||
|
[Description("Max bytes to read. Default 1048576 (1MB). Reduce for large binary-adjacent files.")] int? max_bytes = null,
|
||||||
|
CancellationToken ct = default)
|
||||||
|
{
|
||||||
|
if (filter.IsBlocked($"{owner}/{repo}"))
|
||||||
|
throw new UnauthorizedAccessException($"Repo {owner}/{repo} is on the access blocklist.");
|
||||||
|
|
||||||
|
if (string.IsNullOrWhiteSpace(@ref))
|
||||||
|
{
|
||||||
|
var repoMeta = await gitea.GetRepoAsync(owner, repo, ct);
|
||||||
|
@ref = repoMeta.DefaultBranch;
|
||||||
|
}
|
||||||
|
|
||||||
|
var maxB = Math.Min(max_bytes ?? _opts.MaxFileBytes, _opts.MaxFileBytes);
|
||||||
|
var (content, truncated) = await gitea.GetRawFileAsync(owner, repo, @ref, path, maxB, ct);
|
||||||
|
|
||||||
|
return new
|
||||||
|
{
|
||||||
|
owner,
|
||||||
|
repo,
|
||||||
|
@ref,
|
||||||
|
path,
|
||||||
|
truncated,
|
||||||
|
content,
|
||||||
|
};
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,24 @@
|
|||||||
|
{
|
||||||
|
"Logging": {
|
||||||
|
"LogLevel": {
|
||||||
|
"Default": "Warning",
|
||||||
|
"Microsoft.AspNetCore": "Warning",
|
||||||
|
"GiteaMcp": "Information"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"Gitea": {
|
||||||
|
"BaseUrl": "https://git.zhengchentao.win"
|
||||||
|
},
|
||||||
|
"Jwt": {
|
||||||
|
"Issuer": "https://auth.zhengchentao.win",
|
||||||
|
"Audience": "gitea"
|
||||||
|
},
|
||||||
|
"Mcp": {
|
||||||
|
"OAuthDiscovery": {
|
||||||
|
"Issuer": "https://auth.zhengchentao.win",
|
||||||
|
"AuthorizationEndpoint": "https://auth.zhengchentao.win/authorize",
|
||||||
|
"TokenEndpoint": "https://auth.zhengchentao.win/token",
|
||||||
|
"RegistrationEndpoint": "https://auth.zhengchentao.win/register"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,31 @@
|
|||||||
|
{
|
||||||
|
"Logging": {
|
||||||
|
"LogLevel": {
|
||||||
|
"Default": "Information",
|
||||||
|
"Microsoft.AspNetCore": "Warning",
|
||||||
|
"GiteaMcp": "Debug"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"AllowedHosts": "*",
|
||||||
|
"Gitea": {
|
||||||
|
"BaseUrl": "https://git.zhengchentao.win",
|
||||||
|
"AdminPat": "",
|
||||||
|
"RepoBlacklist": "",
|
||||||
|
"DefaultLimit": 50,
|
||||||
|
"MaxFileBytes": 1048576
|
||||||
|
},
|
||||||
|
"Jwt": {
|
||||||
|
"Issuer": "https://auth.zhengchentao.win",
|
||||||
|
"Audience": "gitea",
|
||||||
|
"SigningKeyCurrent": "",
|
||||||
|
"SigningKeyPrevious": ""
|
||||||
|
},
|
||||||
|
"Mcp": {
|
||||||
|
"OAuthDiscovery": {
|
||||||
|
"Issuer": "https://auth.zhengchentao.win",
|
||||||
|
"AuthorizationEndpoint": "https://auth.zhengchentao.win/authorize",
|
||||||
|
"TokenEndpoint": "https://auth.zhengchentao.win/token",
|
||||||
|
"RegistrationEndpoint": "https://auth.zhengchentao.win/register"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,111 @@
|
|||||||
|
using GiteaMcp.Config;
|
||||||
|
using GiteaMcp.Services;
|
||||||
|
using GiteaMcp.Services.Models;
|
||||||
|
using Microsoft.Extensions.Options;
|
||||||
|
using Xunit;
|
||||||
|
|
||||||
|
namespace GiteaMcp.Tests;
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// GiteaRepoFilter 单元测试。
|
||||||
|
/// 验证黑名单过滤的核心行为：精确匹配、大小写不敏感、空黑名单全通过。
|
||||||
|
/// </summary>
|
||||||
|
public class GiteaRepoFilterTests
|
||||||
|
{
|
||||||
|
private static GiteaRepoFilter CreateFilter(string blacklist) =>
|
||||||
|
new(Options.Create(new GiteaOptions { RepoBlacklist = blacklist }));
|
||||||
|
|
||||||
|
private static GiteaRepo MakeRepo(string owner, string name) => new()
|
||||||
|
{
|
||||||
|
Name = name,
|
||||||
|
FullName = $"{owner}/{name}",
|
||||||
|
Owner = new GiteaUser { Login = owner },
|
||||||
|
};
|
||||||
|
|
||||||
|
[Fact]
|
||||||
|
public void EmptyBlacklist_AllowsEverything()
|
||||||
|
{
|
||||||
|
var filter = CreateFilter("");
|
||||||
|
var repos = new List<GiteaRepo>
|
||||||
|
{
|
||||||
|
MakeRepo("alice", "repo-a"),
|
||||||
|
MakeRepo("org", "private-repo"),
|
||||||
|
};
|
||||||
|
|
||||||
|
var result = filter.Filter(repos);
|
||||||
|
|
||||||
|
Assert.Equal(2, result.Count);
|
||||||
|
Assert.Equal(0, filter.BlacklistCount);
|
||||||
|
}
|
||||||
|
|
||||||
|
[Fact]
|
||||||
|
public void SingleEntry_BlocksExactMatch()
|
||||||
|
{
|
||||||
|
var filter = CreateFilter("alice/secret-repo");
|
||||||
|
var repos = new List<GiteaRepo>
|
||||||
|
{
|
||||||
|
MakeRepo("alice", "secret-repo"),
|
||||||
|
MakeRepo("alice", "public-repo"),
|
||||||
|
};
|
||||||
|
|
||||||
|
var result = filter.Filter(repos);
|
||||||
|
|
||||||
|
Assert.Single(result);
|
||||||
|
Assert.Equal("public-repo", result[0].Name);
|
||||||
|
}
|
||||||
|
|
||||||
|
[Fact]
|
||||||
|
public void MultipleEntries_CommaSeparated()
|
||||||
|
{
|
||||||
|
var filter = CreateFilter("alice/repo-a, org/internal , bob/secret");
|
||||||
|
var repos = new List<GiteaRepo>
|
||||||
|
{
|
||||||
|
MakeRepo("alice", "repo-a"),
|
||||||
|
MakeRepo("org", "internal"),
|
||||||
|
MakeRepo("bob", "secret"),
|
||||||
|
MakeRepo("bob", "public"),
|
||||||
|
};
|
||||||
|
|
||||||
|
var result = filter.Filter(repos);
|
||||||
|
|
||||||
|
Assert.Single(result);
|
||||||
|
Assert.Equal("public", result[0].Name);
|
||||||
|
}
|
||||||
|
|
||||||
|
[Fact]
|
||||||
|
public void IsBlocked_CaseInsensitive()
|
||||||
|
{
|
||||||
|
var filter = CreateFilter("Alice/Secret-Repo");
|
||||||
|
|
||||||
|
// 大写 owner / 混合大小写 repo 都应该被屏蔽
|
||||||
|
Assert.True(filter.IsBlocked("alice/secret-repo"));
|
||||||
|
Assert.True(filter.IsBlocked("ALICE/SECRET-REPO"));
|
||||||
|
Assert.False(filter.IsBlocked("alice/other-repo"));
|
||||||
|
}
|
||||||
|
|
||||||
|
[Fact]
|
||||||
|
public void Filter_DoesNotMutateOriginalList()
|
||||||
|
{
|
||||||
|
var filter = CreateFilter("alice/repo-a");
|
||||||
|
var original = new List<GiteaRepo>
|
||||||
|
{
|
||||||
|
MakeRepo("alice", "repo-a"),
|
||||||
|
MakeRepo("alice", "repo-b"),
|
||||||
|
};
|
||||||
|
var originalCount = original.Count;
|
||||||
|
|
||||||
|
var filtered = filter.Filter(original);
|
||||||
|
|
||||||
|
// 原列表不应被修改
|
||||||
|
Assert.Equal(originalCount, original.Count);
|
||||||
|
Assert.Single(filtered);
|
||||||
|
}
|
||||||
|
|
||||||
|
[Fact]
|
||||||
|
public void IsBlocked_ReturnsFalse_ForNonBlockedRepo()
|
||||||
|
{
|
||||||
|
var filter = CreateFilter("alice/secret");
|
||||||
|
Assert.False(filter.IsBlocked("alice/public"));
|
||||||
|
Assert.False(filter.IsBlocked("bob/anything"));
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,24 @@
|
|||||||
|
<Project Sdk="Microsoft.NET.Sdk">
|
||||||
|
|
||||||
|
<PropertyGroup>
|
||||||
|
<TargetFramework>net10.0</TargetFramework>
|
||||||
|
<Nullable>enable</Nullable>
|
||||||
|
<ImplicitUsings>enable</ImplicitUsings>
|
||||||
|
<IsPackable>false</IsPackable>
|
||||||
|
<RootNamespace>GiteaMcp.Tests</RootNamespace>
|
||||||
|
</PropertyGroup>
|
||||||
|
|
||||||
|
<ItemGroup>
|
||||||
|
<PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.*" />
|
||||||
|
<PackageReference Include="xunit" Version="2.*" />
|
||||||
|
<PackageReference Include="xunit.runner.visualstudio" Version="2.*">
|
||||||
|
<IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
|
||||||
|
<PrivateAssets>all</PrivateAssets>
|
||||||
|
</PackageReference>
|
||||||
|
</ItemGroup>
|
||||||
|
|
||||||
|
<ItemGroup>
|
||||||
|
<ProjectReference Include="..\gitea-mcp.csproj" />
|
||||||
|
</ItemGroup>
|
||||||
|
|
||||||
|
</Project>
|
||||||
@@ -0,0 +1,32 @@
|
|||||||
|
<Project Sdk="Microsoft.NET.Sdk.Web">
|
||||||
|
|
||||||
|
<PropertyGroup>
|
||||||
|
<TargetFramework>net10.0</TargetFramework>
|
||||||
|
<Nullable>enable</Nullable>
|
||||||
|
<ImplicitUsings>enable</ImplicitUsings>
|
||||||
|
<RootNamespace>GiteaMcp</RootNamespace>
|
||||||
|
<AssemblyName>gitea-mcp</AssemblyName>
|
||||||
|
</PropertyGroup>
|
||||||
|
|
||||||
|
<!-- 排除 Tests 子目录，避免 SDK.Web 的通配符 glob 把测试文件包进主项目 -->
|
||||||
|
<ItemGroup>
|
||||||
|
<Compile Remove="gitea-mcp.Tests/**" />
|
||||||
|
<Content Remove="gitea-mcp.Tests/**" />
|
||||||
|
<EmbeddedResource Remove="gitea-mcp.Tests/**" />
|
||||||
|
<None Remove="gitea-mcp.Tests/**" />
|
||||||
|
</ItemGroup>
|
||||||
|
|
||||||
|
<ItemGroup>
|
||||||
|
<!-- MCP SDK：Streamable HTTP transport + ASP.NET Core 集成 -->
|
||||||
|
<PackageReference Include="ModelContextProtocol" Version="0.*" />
|
||||||
|
<PackageReference Include="ModelContextProtocol.AspNetCore" Version="0.*" />
|
||||||
|
|
||||||
|
<!-- JWT Bearer 认证（与 nas-auth 同款 HS256） -->
|
||||||
|
<PackageReference Include="Microsoft.AspNetCore.Authentication.JwtBearer" Version="10.0.*" />
|
||||||
|
<PackageReference Include="Microsoft.IdentityModel.Tokens" Version="8.*" />
|
||||||
|
|
||||||
|
<!-- HttpClient 弹性策略（retry + backoff） -->
|
||||||
|
<PackageReference Include="Microsoft.Extensions.Http.Resilience" Version="9.*" />
|
||||||
|
</ItemGroup>
|
||||||
|
|
||||||
|
</Project>
|
||||||
@@ -0,0 +1,4 @@
|
|||||||
|
<Solution>
|
||||||
|
<Project Path="gitea-mcp.csproj" />
|
||||||
|
<Project Path="gitea-mcp.Tests/gitea-mcp.Tests.csproj" />
|
||||||
|
</Solution>
|
||||||
Reference in New Issue
Block a user