feat(org): add MCP tools for organization-level labels (list/create/edit/delete) (#99) (#102)

This PR adds full support for managing organization-level labels via MCP. It uses the newly added SDK APIs now available on main branch, see gitea/go-sdk#732. Registers following tools under label module and wires them into the MCP server as read/write tools: - list_org_labels: list labels defined at the organization level (pagination supported) - create_org_label: create a label in an organization (name, color, description, exclusive) - edit_org_label: edit an organization label (name, color, description, exclusive) - delete_org_label: delete an organization label by ID Dependency note: go.mod/go.sum updated to use the SDK main branch pseudo-version that includes the org-label APIs. If you prefer to merge only after a tagged SDK release, I can bump the dependency to the new tag as soon as it’s available. Thanks for considering! Reviewed-on: #102 Reviewed-by: Bo-Yi Wu (吳柏毅) <appleboy.tw@gmail.com> Co-authored-by: Daniel <danielwichers@gmail.com> Co-committed-by: Daniel <danielwichers@gmail.com>
2025-10-20 01:43:39 +00:00
parent 98f908d5a1
commit f6b45fdf6e
4 changed files with 189 additions and 3 deletions
--- a/README.md
+++ b/README.md
@@ -201,6 +201,10 @@ The Gitea MCP Server supports the following tools:
 | create_pull_request | Pull Request | Create a new pull request | 
 | search_users | User | Search for users | 
 | search_org_teams | Organization | Search for teams in an organization | 
+| list_org_labels | Organization | List labels defined at organization level | 
+| create_org_label | Organization | Create a label in an organization | 
+| edit_org_label | Organization | Edit a label in an organization | 
+| delete_org_label | Organization | Delete a label in an organization | 
 | search_repos | Repository | Search for repositories | 
 | get_gitea_mcp_server_version | Server | Get the version of the Gitea MCP Server | 
 | list_wiki_pages | Wiki | List all wiki pages in a repository | 
--- a/go.mod
+++ b/go.mod
@@ -3,7 +3,7 @@ module gitea.com/gitea/gitea-mcp
 go 1.24.0 
 
 require ( 
-code.gitea.io/sdk/gitea v0.22.0 
+code.gitea.io/sdk/gitea v0.22.1-0.20251016220613-060554f46291 
 github.com/mark3labs/mcp-go v0.40.0 
 go.uber.org/zap v1.27.0 
 gopkg.in/natefinch/lumberjack.v2 v2.2.1 
--- a/go.sum
+++ b/go.sum
@@ -1,5 +1,5 @@
-code.gitea.io/sdk/gitea v0.22.0 h1:HCKq7bX/HQ85Nw7c/HAhWgRye+vBp5nQOE8Md1+9Ef0= 
-code.gitea.io/sdk/gitea v0.22.0/go.mod h1:yyF5+GhljqvA30sRDreoyHILruNiy4ASufugzYg0VHM= 
+code.gitea.io/sdk/gitea v0.22.1-0.20251016220613-060554f46291 h1:oVIBPpbLraXywuuapimBbI3uMRGF0qJP3wjU2vb2bU4= 
+code.gitea.io/sdk/gitea v0.22.1-0.20251016220613-060554f46291/go.mod h1:yyF5+GhljqvA30sRDreoyHILruNiy4ASufugzYg0VHM= 
 github.com/42wim/httpsig v1.2.3 h1:xb0YyWhkYj57SPtfSttIobJUPJZB9as1nsfo7KWVcEs= 
 github.com/42wim/httpsig v1.2.3/go.mod h1:nZq9OlYKDrUBhptd77IHx4/sZZD+IxTBADvAPI9G/EM= 
 github.com/bahlo/generic-list-go v0.2.0 h1:5sz/EEAK+ls5wF+NeqDpk5+iNdMDXrh3z3nPnH1Wvgk= 
--- a/operation/label/label.go
+++ b/operation/label/label.go
@@ -27,6 +27,10 @@ const (
 ReplaceIssueLabelsToolName = "replace_issue_labels" 
 ClearIssueLabelsToolName = "clear_issue_labels" 
 RemoveIssueLabelToolName = "remove_issue_label" 
+ ListOrgLabelsToolName = "list_org_labels" 
+ CreateOrgLabelToolName = "create_org_label" 
+ EditOrgLabelToolName = "edit_org_label" 
+ DeleteOrgLabelToolName = "delete_org_label" 
 ) 
 
 var ( 
@@ -110,6 +114,43 @@ var (
 mcp.WithNumber("index", mcp.Required(), mcp.Description("issue index")), 
 mcp.WithNumber("label_id", mcp.Required(), mcp.Description("label ID to remove")), 
 ) 
+ 
+ ListOrgLabelsTool = mcp.NewTool( 
+ ListOrgLabelsToolName, 
+ mcp.WithDescription("Lists labels defined at organization level"), 
+ mcp.WithString("org", mcp.Required(), mcp.Description("organization name")), 
+ mcp.WithNumber("page", mcp.Description("page number"), mcp.DefaultNumber(1)), 
+ mcp.WithNumber("pageSize", mcp.Description("page size"), mcp.DefaultNumber(100)), 
+ ) 
+ 
+ CreateOrgLabelTool = mcp.NewTool( 
+ CreateOrgLabelToolName, 
+ mcp.WithDescription("Creates a new label for an organization"), 
+ mcp.WithString("org", mcp.Required(), mcp.Description("organization name")), 
+ mcp.WithString("name", mcp.Required(), mcp.Description("label name")), 
+ mcp.WithString("color", mcp.Required(), mcp.Description("label color (hex code, e.g., #RRGGBB)")), 
+ mcp.WithString("description", mcp.Description("label description")), 
+ mcp.WithBoolean("exclusive", mcp.Description("whether the label is exclusive"), mcp.DefaultBool(false)), 
+ ) 
+ 
+ EditOrgLabelTool = mcp.NewTool( 
+ EditOrgLabelToolName, 
+ mcp.WithDescription("Edits an existing organization label"), 
+ mcp.WithString("org", mcp.Required(), mcp.Description("organization name")), 
+ mcp.WithNumber("id", mcp.Required(), mcp.Description("label ID")), 
+ mcp.WithString("name", mcp.Description("new label name")), 
+ mcp.WithString("color", mcp.Description("new label color (hex code, e.g., #RRGGBB)")), 
+ mcp.WithString("description", mcp.Description("new label description")), 
+ mcp.WithBoolean("exclusive", mcp.Description("whether the label is exclusive")), 
+ ) 
+ 
+ DeleteOrgLabelTool = mcp.NewTool( 
+ DeleteOrgLabelToolName, 
+ mcp.WithDescription("Deletes an organization label by ID"), 
+ mcp.WithString("org", mcp.Required(), mcp.Description("organization name")), 
+ mcp.WithNumber("id", mcp.Required(), mcp.Description("label ID")), 
+ ) 
+ 
 ) 
 
 func init() { 
@@ -149,6 +190,22 @@ func init() {
 Tool: RemoveIssueLabelTool, 
 Handler: RemoveIssueLabelFn, 
 }) 
+ Tool.RegisterRead(server.ServerTool{ 
+ Tool: ListOrgLabelsTool, 
+ Handler: ListOrgLabelsFn, 
+ }) 
+ Tool.RegisterWrite(server.ServerTool{ 
+ Tool: CreateOrgLabelTool, 
+ Handler: CreateOrgLabelFn, 
+ }) 
+ Tool.RegisterWrite(server.ServerTool{ 
+ Tool: EditOrgLabelTool, 
+ Handler: EditOrgLabelFn, 
+ }) 
+ Tool.RegisterWrite(server.ServerTool{ 
+ Tool: DeleteOrgLabelTool, 
+ Handler: DeleteOrgLabelFn, 
+ }) 
 } 
 
 func ListRepoLabelsFn(ctx context.Context, req mcp.CallToolRequest) (*mcp.CallToolResult, error) { 
@@ -452,3 +509,128 @@ func RemoveIssueLabelFn(ctx context.Context, req mcp.CallToolRequest) (*mcp.Call
 } 
 return to.TextResult("Label removed successfully") 
 } 
+ 
+func ListOrgLabelsFn(ctx context.Context, req mcp.CallToolRequest) (*mcp.CallToolResult, error) { 
+ log.Debugf("Called ListOrgLabelsFn") 
+ org, ok := req.GetArguments()["org"].(string) 
+ if !ok { 
+ return to.ErrorResult(fmt.Errorf("org is required")) 
+ } 
+ page, ok := req.GetArguments()["page"].(float64) 
+ if !ok { 
+ page = 1 
+ } 
+ pageSize, ok := req.GetArguments()["pageSize"].(float64) 
+ if !ok { 
+ pageSize = 100 
+ } 
+ 
+ opt := gitea_sdk.ListOrgLabelsOptions{ 
+ ListOptions: gitea_sdk.ListOptions{ 
+ Page: int(page), 
+ PageSize: int(pageSize), 
+ }, 
+ } 
+ client, err := gitea.ClientFromContext(ctx) 
+ if err != nil { 
+ return to.ErrorResult(fmt.Errorf("get gitea client err: %v", err)) 
+ } 
+ labels, _, err := client.ListOrgLabels(org, opt) 
+ if err != nil { 
+ return to.ErrorResult(fmt.Errorf("list %v/labels err: %v", org, err)) 
+ } 
+ return to.TextResult(labels) 
+} 
+ 
+func CreateOrgLabelFn(ctx context.Context, req mcp.CallToolRequest) (*mcp.CallToolResult, error) { 
+ log.Debugf("Called CreateOrgLabelFn") 
+ org, ok := req.GetArguments()["org"].(string) 
+ if !ok { 
+ return to.ErrorResult(fmt.Errorf("org is required")) 
+ } 
+ name, ok := req.GetArguments()["name"].(string) 
+ if !ok { 
+ return to.ErrorResult(fmt.Errorf("name is required")) 
+ } 
+ color, ok := req.GetArguments()["color"].(string) 
+ if !ok { 
+ return to.ErrorResult(fmt.Errorf("color is required")) 
+ } 
+ description, _ := req.GetArguments()["description"].(string) 
+ exclusive, _ := req.GetArguments()["exclusive"].(bool) 
+ 
+ opt := gitea_sdk.CreateOrgLabelOption{ 
+ Name: name, 
+ Color: color, 
+ Description: description, 
+ Exclusive: exclusive, 
+ } 
+ 
+ client, err := gitea.ClientFromContext(ctx) 
+ if err != nil { 
+ return to.ErrorResult(fmt.Errorf("get gitea client err: %v", err)) 
+ } 
+ label, _, err := client.CreateOrgLabel(org, opt) 
+ if err != nil { 
+ return to.ErrorResult(fmt.Errorf("create %v/labels err: %v", org, err)) 
+ } 
+ return to.TextResult(label) 
+} 
+ 
+func EditOrgLabelFn(ctx context.Context, req mcp.CallToolRequest) (*mcp.CallToolResult, error) { 
+ log.Debugf("Called EditOrgLabelFn") 
+ org, ok := req.GetArguments()["org"].(string) 
+ if !ok { 
+ return to.ErrorResult(fmt.Errorf("org is required")) 
+ } 
+ id, ok := req.GetArguments()["id"].(float64) 
+ if !ok { 
+ return to.ErrorResult(fmt.Errorf("label ID is required")) 
+ } 
+ 
+ opt := gitea_sdk.EditOrgLabelOption{} 
+ if name, ok := req.GetArguments()["name"].(string); ok { 
+ opt.Name = ptr.To(name) 
+ } 
+ if color, ok := req.GetArguments()["color"].(string); ok { 
+ opt.Color = ptr.To(color) 
+ } 
+ if description, ok := req.GetArguments()["description"].(string); ok { 
+ opt.Description = ptr.To(description) 
+ } 
+ if exclusive, ok := req.GetArguments()["exclusive"].(bool); ok { 
+ opt.Exclusive = ptr.To(exclusive) 
+ } 
+ 
+ client, err := gitea.ClientFromContext(ctx) 
+ if err != nil { 
+ return to.ErrorResult(fmt.Errorf("get gitea client err: %v", err)) 
+ } 
+ label, _, err := client.EditOrgLabel(org, int64(id), opt) 
+ if err != nil { 
+ return to.ErrorResult(fmt.Errorf("edit %v/labels/%v err: %v", org, int64(id), err)) 
+ } 
+ return to.TextResult(label) 
+} 
+ 
+func DeleteOrgLabelFn(ctx context.Context, req mcp.CallToolRequest) (*mcp.CallToolResult, error) { 
+ log.Debugf("Called DeleteOrgLabelFn") 
+ org, ok := req.GetArguments()["org"].(string) 
+ if !ok { 
+ return to.ErrorResult(fmt.Errorf("org is required")) 
+ } 
+ id, ok := req.GetArguments()["id"].(float64) 
+ if !ok { 
+ return to.ErrorResult(fmt.Errorf("label ID is required")) 
+ } 
+ 
+ client, err := gitea.ClientFromContext(ctx) 
+ if err != nil { 
+ return to.ErrorResult(fmt.Errorf("get gitea client err: %v", err)) 
+ } 
+ _, err = client.DeleteOrgLabel(org, int64(id)) 
+ if err != nil { 
+ return to.ErrorResult(fmt.Errorf("delete %v/labels/%v err: %v", org, int64(id), err)) 
+ } 
+ return to.TextResult("Label deleted successfully") 
+}