add tag

2025-04-10 07:53:48 +00:00
parent d7fc614fd5
commit ab5cbb7467
5 changed files with 183 additions and 1 deletions
--- a/README.md
+++ b/README.md
@@ -158,6 +158,10 @@ The Gitea MCP Server supports the following tools:
 | delete_release | Release | Delete a release from a repository | 
 | get_release | Release | Get a release | 
 | list_releases | Release | List all releases in a repository | 
+| create_tag | Tag | Create a new tag | 
+| delete_tag | Tag | Delete a tag | 
+| get_tag | Tag | Get a tag | 
+| list_tags | Tag | List all tags in a repository | 
 | list_repo_commits | Commit | List all commits in a repository | 
 | get_file_content | File | Get the content and metadata of a file | 
 | create_file | File | Create a new file | 
--- a/README.zh-cn.md
+++ b/README.zh-cn.md
@@ -154,6 +154,14 @@ Gitea MCP 服务器支持以下工具：
 | create_branch | 分支 | 创建一个新分支 | 
 | delete_branch | 分支 | 删除一个分支 | 
 | list_branches | 分支 | 列出仓库中的所有分支 | 
+| create_release | 版本发布 | 创建一个新版本发布 | 
+| delete_release | 版本发布 | 删除一个版本发布 | 
+| get_release | 版本发布 | 获取一个版本发布 | 
+| list_releases | 版本发布 | 列出所有版本发布 | 
+| create_tag | 标签 | 创建一个新标签 | 
+| delete_tag | 标签 | 删除一个标签 | 
+| get_tag | 标签 | 获取一个标签 | 
+| list_tags | 标签 | 列出所有标签 | 
 | list_repo_commits | 提交 | 列出仓库中的所有提交 | 
 | get_file_content | 文件 | 获取文件的内容和元数据 | 
 | create_file | 文件 | 创建一个新文件 | 
--- a/README.zh-tw.md
+++ b/README.zh-tw.md
@@ -144,7 +144,6 @@ cp gitea-mcp /usr/local/bin/
 ## ✅ 可用工具 
 
 Gitea MCP 伺服器支持以下工具： 
- 
 | 工具 | 範圍 | 描述 | 
 | :--------------------------: | :------: | :--------------------------: | 
 | get_my_user_info | 用戶 | 獲取已認證用戶的信息 | 
@@ -154,6 +153,14 @@ Gitea MCP 伺服器支持以下工具：
 | create_branch | 分支 | 創建一個新分支 | 
 | delete_branch | 分支 | 刪除一個分支 | 
 | list_branches | 分支 | 列出倉庫中的所有分支 | 
+| create_release | 版本發布 | 創建一個新版本發布 | 
+| delete_release | 版本發布 | 刪除一個版本發布 | 
+| get_release | 版本發布 | 獲取一個版本發布 | 
+| list_releases | 版本發布 | 列出所有版本發布 | 
+| create_tag | 標籤 | 創建一個新標籤 | 
+| delete_tag | 標籤 | 刪除一個標籤 | 
+| get_tag | 標籤 | 獲取一個標籤 | 
+| list_tags | 標籤 | 列出所有標籤 | 
 | list_repo_commits | 提交 | 列出倉庫中的所有提交 | 
 | get_file_content | 文件 | 獲取文件的內容和元數據 | 
 | create_file | 文件 | 創建一個新文件 | 
--- a/operation/repo/repo.go
+++ b/operation/repo/repo.go
@@ -76,6 +76,12 @@ func RegisterTool(s *server.MCPServer) {
 s.AddTool(GetReleaseTool, GetReleaseFn) 
 s.AddTool(ListReleasesTool, ListReleasesFn) 
 
+// Tag 
+s.AddTool(CreateTagTool, CreateTagFn) 
+s.AddTool(DeleteTagTool, DeleteTagFn) 
+s.AddTool(GetTagTool, GetTagFn) 
+s.AddTool(ListTagsTool, ListTagsFn) 
+ 
 // Commit 
 s.AddTool(ListRepoCommitsTool, ListRepoCommitsFn) 
 } 
--- a/operation/repo/tag.go
+++ b/operation/repo/tag.go
@@ -0,0 +1,157 @@
+package repo 
+ 
+import ( 
+"context" 
+"fmt" 
+ 
+gitea_sdk "code.gitea.io/sdk/gitea" 
+"gitea.com/gitea/gitea-mcp/pkg/gitea" 
+"gitea.com/gitea/gitea-mcp/pkg/log" 
+"gitea.com/gitea/gitea-mcp/pkg/to" 
+"github.com/mark3labs/mcp-go/mcp" 
+) 
+ 
+const ( 
+CreateTagToolName = "create_tag" 
+DeleteTagToolName = "delete_tag" 
+GetTagToolName = "get_tag" 
+ListTagsToolName = "list_tags" 
+) 
+ 
+var ( 
+CreateTagTool = mcp.NewTool( 
+CreateTagToolName, 
+mcp.WithDescription("Create tag"), 
+mcp.WithString("owner", mcp.Required(), mcp.Description("repository owner")), 
+mcp.WithString("repo", mcp.Required(), mcp.Description("repository name")), 
+mcp.WithString("tag_name", mcp.Required(), mcp.Description("tag name")), 
+mcp.WithString("target", mcp.Description("target commitish"), mcp.DefaultString("")), 
+mcp.WithString("message", mcp.Description("tag message"), mcp.DefaultString("")), 
+) 
+ 
+DeleteTagTool = mcp.NewTool( 
+DeleteTagToolName, 
+mcp.WithDescription("Delete tag"), 
+mcp.WithString("owner", mcp.Required(), mcp.Description("repository owner")), 
+mcp.WithString("repo", mcp.Required(), mcp.Description("repository name")), 
+mcp.WithString("tag_name", mcp.Required(), mcp.Description("tag name")), 
+) 
+ 
+GetTagTool = mcp.NewTool( 
+GetTagToolName, 
+mcp.WithDescription("Get tag"), 
+mcp.WithString("owner", mcp.Required(), mcp.Description("repository owner")), 
+mcp.WithString("repo", mcp.Required(), mcp.Description("repository name")), 
+mcp.WithString("tag_name", mcp.Required(), mcp.Description("tag name")), 
+) 
+ 
+ListTagsTool = mcp.NewTool( 
+ListTagsToolName, 
+mcp.WithDescription("List tags"), 
+mcp.WithString("owner", mcp.Required(), mcp.Description("repository owner")), 
+mcp.WithString("repo", mcp.Required(), mcp.Description("repository name")), 
+mcp.WithNumber("page", mcp.Description("page number"), mcp.DefaultNumber(1), mcp.Min(1)), 
+mcp.WithNumber("pageSize", mcp.Description("page size"), mcp.DefaultNumber(100), mcp.Min(1)), 
+) 
+) 
+ 
+func CreateTagFn(ctx context.Context, req mcp.CallToolRequest) (*mcp.CallToolResult, error) { 
+log.Debugf("Called CreateTagFn") 
+owner, ok := req.Params.Arguments["owner"].(string) 
+if !ok { 
+return nil, fmt.Errorf("owner is required") 
+} 
+repo, ok := req.Params.Arguments["repo"].(string) 
+if !ok { 
+return nil, fmt.Errorf("repo is required") 
+} 
+tagName, ok := req.Params.Arguments["tag_name"].(string) 
+if !ok { 
+return nil, fmt.Errorf("tag_name is required") 
+} 
+target, _ := req.Params.Arguments["target"].(string) 
+message, _ := req.Params.Arguments["message"].(string) 
+ 
+_, _, err := gitea.Client().CreateTag(owner, repo, gitea_sdk.CreateTagOption{ 
+TagName: tagName, 
+Target: target, 
+Message: message, 
+}) 
+if err != nil { 
+return nil, fmt.Errorf("create tag error: %v", err) 
+} 
+ 
+return mcp.NewToolResultText("Tag Created"), nil 
+} 
+ 
+func DeleteTagFn(ctx context.Context, req mcp.CallToolRequest) (*mcp.CallToolResult, error) { 
+log.Debugf("Called DeleteTagFn") 
+owner, ok := req.Params.Arguments["owner"].(string) 
+if !ok { 
+return nil, fmt.Errorf("owner is required") 
+} 
+repo, ok := req.Params.Arguments["repo"].(string) 
+if !ok { 
+return nil, fmt.Errorf("repo is required") 
+} 
+tagName, ok := req.Params.Arguments["tag_name"].(string) 
+if !ok { 
+return nil, fmt.Errorf("tag_name is required") 
+} 
+ 
+_, err := gitea.Client().DeleteTag(owner, repo, tagName) 
+if err != nil { 
+return nil, fmt.Errorf("delete tag error: %v", err) 
+} 
+ 
+return to.TextResult("Tag deleted") 
+} 
+ 
+func GetTagFn(ctx context.Context, req mcp.CallToolRequest) (*mcp.CallToolResult, error) { 
+log.Debugf("Called GetTagFn") 
+owner, ok := req.Params.Arguments["owner"].(string) 
+if !ok { 
+return nil, fmt.Errorf("owner is required") 
+} 
+repo, ok := req.Params.Arguments["repo"].(string) 
+if !ok { 
+return nil, fmt.Errorf("repo is required") 
+} 
+tagName, ok := req.Params.Arguments["tag_name"].(string) 
+if !ok { 
+return nil, fmt.Errorf("tag_name is required") 
+} 
+ 
+tag, _, err := gitea.Client().GetTag(owner, repo, tagName) 
+if err != nil { 
+return nil, fmt.Errorf("get tag error: %v", err) 
+} 
+ 
+return to.TextResult(tag) 
+} 
+ 
+func ListTagsFn(ctx context.Context, req mcp.CallToolRequest) (*mcp.CallToolResult, error) { 
+log.Debugf("Called ListTagsFn") 
+owner, ok := req.Params.Arguments["owner"].(string) 
+if !ok { 
+return nil, fmt.Errorf("owner is required") 
+} 
+repo, ok := req.Params.Arguments["repo"].(string) 
+if !ok { 
+return nil, fmt.Errorf("repo is required") 
+} 
+page, _ := req.Params.Arguments["page"].(int) 
+pageSize, _ := req.Params.Arguments["pageSize"].(int) 
+ 
+tags, _, err := gitea.Client().ListRepoTags(owner, repo, gitea_sdk.ListRepoTagsOptions{ 
+ListOptions: gitea_sdk.ListOptions{ 
+Page: page, 
+PageSize: pageSize, 
+}, 
+}) 
+if err != nil { 
+return nil, fmt.Errorf("list tags error: %v", err) 
+} 
+ 
+return to.TextResult(tags) 
+}