### Install Gitea MCP to GOPATH/bin Source: https://github.com/gitea/gitea-mcp/blob/main/CLAUDE.md Builds and installs the gitea-mcp binary to your Go bin directory. This makes the command accessible from your PATH. ```bash make install ``` -------------------------------- ### Start Gitea MCP Development Server with Hot Reload Source: https://github.com/gitea/gitea-mcp/blob/main/CLAUDE.md Starts the development server with hot reload capabilities using 'air'. Ensure 'air' is installed. ```bash make dev ``` -------------------------------- ### Example MCP Chatbot Command Source: https://github.com/gitea/gitea-mcp/blob/main/README.md An example command to interact with the MCP-compatible chatbot to list repositories. This demonstrates a typical user interaction after configuration. ```text list all my repositories ``` -------------------------------- ### Build Gitea MCP Binary Source: https://github.com/gitea/gitea-mcp/blob/main/CLAUDE.md Use this command to build the gitea-mcp binary. Ensure you have Go installed and configured. ```bash make build ``` -------------------------------- ### Install gitea-mcp Binary Source: https://github.com/gitea/gitea-mcp/blob/main/README.md Copy the gitea-mcp binary to a directory in your system's PATH for easy access. This ensures the command can be run from any location. ```bash cp gitea-mcp /usr/local/bin/ ``` -------------------------------- ### Add Gitea MCP Server using Claude CLI Source: https://github.com/gitea/gitea-mcp/blob/main/README.md Use this command to add the Gitea MCP server via the Claude CLI. Ensure Go is installed and the Gitea access token and host are configured. ```bash claude mcp add --transport stdio --scope user gitea \ --env GITEA_ACCESS_TOKEN=token \ --env GITEA_HOST=https://gitea.com \ -- go run gitea.com/gitea/gitea-mcp@latest -t stdio ``` -------------------------------- ### PowerShell Build Script Commands Source: https://github.com/gitea/gitea-mcp/blob/main/BUILDING.md Use these commands with the `build.ps1` script to manage the gitea-mcp build process on Windows. Ensure PowerShell 5.1 or later is installed. ```powershell # Show help .uild.ps1 help ``` ```powershell # Build the application .uild.ps1 build ``` ```powershell # Install the application .uild.ps1 install ``` ```powershell # Clean build artifacts .uild.ps1 clean ``` ```powershell # Run in development mode (hot reload) .uild.ps1 dev ``` ```powershell # Update vendor dependencies .uild.ps1 vendor ``` -------------------------------- ### Clone Gitea MCP Server Source Code Source: https://github.com/gitea/gitea-mcp/blob/main/README.md Clone the Gitea MCP Server repository using Git to build from source. Ensure Git is installed. ```bash git clone https://gitea.com/gitea/gitea-mcp.git ``` -------------------------------- ### Tidy and Verify Gitea MCP Module Dependencies Source: https://github.com/gitea/gitea-mcp/blob/main/CLAUDE.md Manages Go module dependencies, tidying and verifying them. Recommended before committing changes. ```bash make vendor ``` -------------------------------- ### Configure Gitea MCP Server (stdio mode) Source: https://github.com/gitea/gitea-mcp/blob/main/README.md Configure the MCP server for Gitea using stdio mode. This mode requires the gitea-mcp command, arguments for host and token, and environment variables for additional settings. ```json { "mcpServers": { "gitea": { "command": "gitea-mcp", "args": [ "-t", "stdio", "--host", "https://gitea.com" // "--token", "" ], "env": { // "GITEA_HOST": "https://gitea.com", // "GITEA_INSECURE": "true", "GITEA_ACCESS_TOKEN": "" } } } } ``` -------------------------------- ### Configure Gitea MCP Server in VS Code Settings Source: https://github.com/gitea/gitea-mcp/blob/main/README.md Add this JSON configuration to your VS Code User Settings for Gitea MCP integration. It includes input prompts for authentication and server command details. ```json { "mcp": { "inputs": [ { "type": "promptString", "id": "gitea_token", "description": "Gitea Personal Access Token", "password": true } ], "servers": { "gitea-mcp": { "command": "docker", "args": [ "run", "-i", "--rm", "-e", "GITEA_ACCESS_TOKEN", "docker.gitea.com/gitea-mcp-server" ], "env": { "GITEA_ACCESS_TOKEN": "${input:gitea_token}" } } } } } ``` -------------------------------- ### Run All Gitea MCP Tests Source: https://github.com/gitea/gitea-mcp/blob/main/CLAUDE.md Executes all tests within the project. This is crucial for verifying code integrity. ```bash go test ./... ``` -------------------------------- ### Configure Gitea MCP Server in Mistral Vibe Source: https://github.com/gitea/gitea-mcp/blob/main/README.md Add this TOML configuration to your Mistral Vibe MCP configuration file for Gitea integration. It specifies the server name, transport, command, and environment variables. ```toml [[mcp_servers]] name = "gitea" transport = "stdio" command = "docker" args = [ "run", "--rm", "-i", "-e", "GITEA_ACCESS_TOKEN", "-e", "GITEA_HOST", "docker.gitea.com/gitea-mcp-server", ] [mcp_servers.env] GITEA_ACCESS_TOKEN = "TOKEN" GITEA_HOST = "https://gitea.com" ``` -------------------------------- ### Configure Gitea MCP Server (http mode) Source: https://github.com/gitea/gitea-mcp/blob/main/README.md Configure the MCP server for Gitea using http mode. This mode requires a URL for the MCP endpoint and an Authorization header with a bearer token. ```json { "mcpServers": { "gitea": { "url": "http://localhost:8080/mcp", "headers": { "Authorization": "Bearer " } } } } ``` -------------------------------- ### Batch File Wrapper for PowerShell Build Script Source: https://github.com/gitea/gitea-mcp/blob/main/BUILDING.md This batch file (`build.bat`) acts as a simple wrapper to execute the main PowerShell build script (`build.ps1`) on Windows. It can be used to run default targets or specific ones. ```cmd # Run with default help target build.bat ``` ```cmd # Run specific target build.bat build build.bat install ``` -------------------------------- ### Enable Debug Mode for Gitea MCP Server Source: https://github.com/gitea/gitea-mcp/blob/main/README.md Add the -d flag when running the Gitea MCP Server in http mode to enable debug logging. Ensure the token and port are correctly specified. ```sh ./gitea-mcp -t http [--port 8080] --token -d ``` -------------------------------- ### Run Specific Gitea MCP Operation Tests Source: https://github.com/gitea/gitea-mcp/blob/main/CLAUDE.md Execute tests for a specific function within the operation package. Replace 'TestFunctionName' with the actual test function name. ```bash go test ./operation -run TestFunctionName ``` -------------------------------- ### Clean Gitea MCP Build Artifacts Source: https://github.com/gitea/gitea-mcp/blob/main/CLAUDE.md Removes build artifacts generated during the build process. Useful for ensuring a clean build. ```bash make clean ``` -------------------------------- ### Repository Operations Source: https://github.com/gitea/gitea-mcp/blob/main/README.md Operations related to searching for repositories. ```APIDOC ## search_repos Repository ### Description Search for repositories based on provided criteria. ### Method GET ### Endpoint /repos ### Parameters #### Query Parameters - **q** (string) - Required - The query string to search for repositories. ``` -------------------------------- ### Server Operations Source: https://github.com/gitea/gitea-mcp/blob/main/README.md Operations related to the Gitea MCP Server. ```APIDOC ## get_gitea_mcp_server_version Server ### Description Get the version of the Gitea MCP Server. ### Method GET ### Endpoint /version ``` -------------------------------- ### Wiki Operations Source: https://github.com/gitea/gitea-mcp/blob/main/README.md Operations related to managing wiki pages for a repository. ```APIDOC ## list_wiki_pages Wiki ### Description List all wiki pages in a repository. ### Method GET ### Endpoint /repos/{owner}/{repo}/wiki/pages ### Parameters #### Path Parameters - **owner** (string) - Required - The owner of the repository. - **repo** (string) - Required - The name of the repository. ``` ```APIDOC ## get_wiki_page Wiki ### Description Get a wiki page content and metadata. ### Method GET ### Endpoint /repos/{owner}/{repo}/wiki/pages/{slug} ### Parameters #### Path Parameters - **owner** (string) - Required - The owner of the repository. - **repo** (string) - Required - The name of the repository. - **slug** (string) - Required - The slug of the wiki page. ``` ```APIDOC ## get_wiki_revisions Wiki ### Description Get revisions history of a wiki page. ### Method GET ### Endpoint /repos/{owner}/{repo}/wiki/pages/{slug}/revisions ### Parameters #### Path Parameters - **owner** (string) - Required - The owner of the repository. - **repo** (string) - Required - The name of the repository. - **slug** (string) - Required - The slug of the wiki page. ``` ```APIDOC ## create_wiki_page Wiki ### Description Create a new wiki page. ### Method POST ### Endpoint /repos/{owner}/{repo}/wiki/pages ### Parameters #### Path Parameters - **owner** (string) - Required - The owner of the repository. - **repo** (string) - Required - The name of the repository. #### Request Body - **title** (string) - Required - The title of the wiki page. - **content** (string) - Required - The content of the wiki page. - **slug** (string) - Optional - The slug for the wiki page URL. ``` ```APIDOC ## update_wiki_page Wiki ### Description Update an existing wiki page. ### Method PUT ### Endpoint /repos/{owner}/{repo}/wiki/pages/{slug} ### Parameters #### Path Parameters - **owner** (string) - Required - The owner of the repository. - **repo** (string) - Required - The name of the repository. - **slug** (string) - Required - The slug of the wiki page to update. #### Request Body - **title** (string) - Optional - The new title for the wiki page. - **content** (string) - Optional - The new content for the wiki page. ``` ```APIDOC ## delete_wiki_page Wiki ### Description Delete a wiki page. ### Method DELETE ### Endpoint /repos/{owner}/{repo}/wiki/pages/{slug} ### Parameters #### Path Parameters - **owner** (string) - Required - The owner of the repository. - **repo** (string) - Required - The name of the repository. - **slug** (string) - Required - The slug of the wiki page to delete. ``` -------------------------------- ### User Operations Source: https://github.com/gitea/gitea-mcp/blob/main/README.md Operations related to searching for users. ```APIDOC ## search_users User ### Description Search for users based on provided criteria. ### Method GET ### Endpoint /users ### Parameters #### Query Parameters - **q** (string) - Required - The query string to search for users. ``` -------------------------------- ### Actions Operations Source: https://github.com/gitea/gitea-mcp/blob/main/README.md Operations related to managing GitHub Actions secrets, variables, workflows, and runs for repositories and organizations. ```APIDOC ## list_repo_action_secrets Actions ### Description List repository Actions secrets (metadata only). ### Method GET ### Endpoint /repos/{owner}/{repo}/actions/secrets ### Parameters #### Path Parameters - **owner** (string) - Required - The owner of the repository. - **repo** (string) - Required - The name of the repository. ``` ```APIDOC ## upsert_repo_action_secret Actions ### Description Create or update (upsert) a repository Actions secret. ### Method PUT ### Endpoint /repos/{owner}/{repo}/actions/secrets/{name} ### Parameters #### Path Parameters - **owner** (string) - Required - The owner of the repository. - **repo** (string) - Required - The name of the repository. - **name** (string) - Required - The name of the secret. #### Request Body - **value** (string) - Required - The value of the secret. ``` ```APIDOC ## delete_repo_action_secret Actions ### Description Delete a repository Actions secret. ### Method DELETE ### Endpoint /repos/{owner}/{repo}/actions/secrets/{name} ### Parameters #### Path Parameters - **owner** (string) - Required - The owner of the repository. - **repo** (string) - Required - The name of the repository. - **name** (string) - Required - The name of the secret. ``` ```APIDOC ## list_org_action_secrets Actions ### Description List organization Actions secrets (metadata only). ### Method GET ### Endpoint /orgs/{org}/actions/secrets ### Parameters #### Path Parameters - **org** (string) - Required - The organization's name. ``` ```APIDOC ## upsert_org_action_secret Actions ### Description Create or update (upsert) an organization Actions secret. ### Method PUT ### Endpoint /orgs/{org}/actions/secrets/{name} ### Parameters #### Path Parameters - **org** (string) - Required - The organization's name. - **name** (string) - Required - The name of the secret. #### Request Body - **value** (string) - Required - The value of the secret. ``` ```APIDOC ## delete_org_action_secret Actions ### Description Delete an organization Actions secret. ### Method DELETE ### Endpoint /orgs/{org}/actions/secrets/{name} ### Parameters #### Path Parameters - **org** (string) - Required - The organization's name. - **name** (string) - Required - The name of the secret. ``` ```APIDOC ## list_repo_action_variables Actions ### Description List repository Actions variables. ### Method GET ### Endpoint /repos/{owner}/{repo}/actions/variables ### Parameters #### Path Parameters - **owner** (string) - Required - The owner of the repository. - **repo** (string) - Required - The name of the repository. ``` ```APIDOC ## get_repo_action_variable Actions ### Description Get a repository Actions variable. ### Method GET ### Endpoint /repos/{owner}/{repo}/actions/variables/{name} ### Parameters #### Path Parameters - **owner** (string) - Required - The owner of the repository. - **repo** (string) - Required - The name of the repository. - **name** (string) - Required - The name of the variable. ``` ```APIDOC ## create_repo_action_variable Actions ### Description Create a repository Actions variable. ### Method POST ### Endpoint /repos/{owner}/{repo}/actions/variables ### Parameters #### Path Parameters - **owner** (string) - Required - The owner of the repository. - **repo** (string) - Required - The name of the repository. #### Request Body - **name** (string) - Required - The name of the variable. - **value** (string) - Required - The value of the variable. ``` ```APIDOC ## update_repo_action_variable Actions ### Description Update a repository Actions variable. ### Method PUT ### Endpoint /repos/{owner}/{repo}/actions/variables/{name} ### Parameters #### Path Parameters - **owner** (string) - Required - The owner of the repository. - **repo** (string) - Required - The name of the repository. - **name** (string) - Required - The name of the variable. #### Request Body - **value** (string) - Required - The new value of the variable. ``` ```APIDOC ## delete_repo_action_variable Actions ### Description Delete a repository Actions variable. ### Method DELETE ### Endpoint /repos/{owner}/{repo}/actions/variables/{name} ### Parameters #### Path Parameters - **owner** (string) - Required - The owner of the repository. - **repo** (string) - Required - The name of the repository. - **name** (string) - Required - The name of the variable. ``` ```APIDOC ## list_org_action_variables Actions ### Description List organization Actions variables. ### Method GET ### Endpoint /orgs/{org}/actions/variables ### Parameters #### Path Parameters - **org** (string) - Required - The organization's name. ``` ```APIDOC ## get_org_action_variable Actions ### Description Get an organization Actions variable. ### Method GET ### Endpoint /orgs/{org}/actions/variables/{name} ### Parameters #### Path Parameters - **org** (string) - Required - The organization's name. - **name** (string) - Required - The name of the variable. ``` ```APIDOC ## create_org_action_variable Actions ### Description Create an organization Actions variable. ### Method POST ### Endpoint /orgs/{org}/actions/variables ### Parameters #### Path Parameters - **org** (string) - Required - The organization's name. #### Request Body - **name** (string) - Required - The name of the variable. - **value** (string) - Required - The value of the variable. ``` ```APIDOC ## update_org_action_variable Actions ### Description Update an organization Actions variable. ### Method PUT ### Endpoint /orgs/{org}/actions/variables/{name} ### Parameters #### Path Parameters - **org** (string) - Required - The organization's name. - **name** (string) - Required - The name of the variable. #### Request Body - **value** (string) - Required - The new value of the variable. ``` ```APIDOC ## delete_org_action_variable Actions ### Description Delete an organization Actions variable. ### Method DELETE ### Endpoint /orgs/{org}/actions/variables/{name} ### Parameters #### Path Parameters - **org** (string) - Required - The organization's name. - **name** (string) - Required - The name of the variable. ``` ```APIDOC ## list_repo_action_workflows Actions ### Description List repository Actions workflows. ### Method GET ### Endpoint /repos/{owner}/{repo}/actions/workflows ### Parameters #### Path Parameters - **owner** (string) - Required - The owner of the repository. - **repo** (string) - Required - The name of the repository. ``` ```APIDOC ## get_repo_action_workflow Actions ### Description Get a repository Actions workflow. ### Method GET ### Endpoint /repos/{owner}/{repo}/actions/workflows/{workflow_id} ### Parameters #### Path Parameters - **owner** (string) - Required - The owner of the repository. - **repo** (string) - Required - The name of the repository. - **workflow_id** (string) - Required - The ID or file name of the workflow. ``` ```APIDOC ## dispatch_repo_action_workflow Actions ### Description Trigger (dispatch) a repository Actions workflow. ### Method POST ### Endpoint /repos/{owner}/{repo}/actions/workflows/{workflow_id}/dispatches ### Parameters #### Path Parameters - **owner** (string) - Required - The owner of the repository. - **repo** (string) - Required - The name of the repository. - **workflow_id** (string) - Required - The ID or file name of the workflow. #### Request Body - **ref** (string) - Required - The Git reference (e.g., branch or tag) for the workflow. - **inputs** (object) - Optional - Key-value pairs for workflow inputs. ``` ```APIDOC ## list_repo_action_runs Actions ### Description List repository Actions runs. ### Method GET ### Endpoint /repos/{owner}/{repo}/actions/runs ### Parameters #### Path Parameters - **owner** (string) - Required - The owner of the repository. - **repo** (string) - Required - The name of the repository. ``` ```APIDOC ## get_repo_action_run Actions ### Description Get a repository Actions run. ### Method GET ### Endpoint /repos/{owner}/{repo}/actions/runs/{run_id} ### Parameters #### Path Parameters - **owner** (string) - Required - The owner of the repository. - **repo** (string) - Required - The name of the repository. - **run_id** (integer) - Required - The ID of the run. ``` ```APIDOC ## cancel_repo_action_run Actions ### Description Cancel a repository Actions run. ### Method POST ### Endpoint /repos/{owner}/{repo}/actions/runs/{run_id}/cancel ### Parameters #### Path Parameters - **owner** (string) - Required - The owner of the repository. - **repo** (string) - Required - The name of the repository. - **run_id** (integer) - Required - The ID of the run to cancel. ``` ```APIDOC ## rerun_repo_action_run Actions ### Description Rerun a repository Actions run. ### Method POST ### Endpoint /repos/{owner}/{repo}/actions/runs/{run_id}/rerun ### Parameters #### Path Parameters - **owner** (string) - Required - The owner of the repository. - **repo** (string) - Required - The name of the repository. - **run_id** (integer) - Required - The ID of the run to rerun. ``` ```APIDOC ## list_repo_action_jobs Actions ### Description List repository Actions jobs. ### Method GET ### Endpoint /repos/{owner}/{repo}/actions/jobs ### Parameters #### Path Parameters - **owner** (string) - Required - The owner of the repository. - **repo** (string) - Required - The name of the repository. ``` ```APIDOC ## list_repo_action_run_jobs Actions ### Description List Actions jobs for a run. ### Method GET ### Endpoint /repos/{owner}/{repo}/actions/runs/{run_id}/jobs ### Parameters #### Path Parameters - **owner** (string) - Required - The owner of the repository. - **repo** (string) - Required - The name of the repository. - **run_id** (integer) - Required - The ID of the run. ``` ```APIDOC ## get_repo_action_job_log_preview Actions ### Description Get a job log preview (tail/limited). ### Method GET ### Endpoint /repos/{owner}/{repo}/actions/jobs/{job_id}/log/preview ### Parameters #### Path Parameters - **owner** (string) - Required - The owner of the repository. - **repo** (string) - Required - The name of the repository. - **job_id** (integer) - Required - The ID of the job. #### Query Parameters - **count** (integer) - Optional - The number of lines to retrieve from the end of the log. ``` ```APIDOC ## download_repo_action_job_log Actions ### Description Download a job log to a file. ### Method GET ### Endpoint /repos/{owner}/{repo}/actions/jobs/{job_id}/log ### Parameters #### Path Parameters - **owner** (string) - Required - The owner of the repository. - **repo** (string) - Required - The name of the repository. - **job_id** (integer) - Required - The ID of the job. ``` -------------------------------- ### Pull Request Operations Source: https://github.com/gitea/gitea-mcp/blob/main/README.md Operations related to managing pull requests, including deleting and dismissing reviews, and merging pull requests. ```APIDOC ## delete_pull_request_review Pull Request ### Description Delete a review for a pull request. ### Method POST ### Endpoint /repos/{owner}/{repo}/pulls/{pull_number}/reviews/{review_id} ### Parameters #### Path Parameters - **owner** (string) - Required - The owner of the repository. - **repo** (string) - Required - The name of the repository. - **pull_number** (integer) - Required - The number of the pull request. - **review_id** (integer) - Required - The ID of the review to delete. ## dismiss_pull_request_review Pull Request ### Description Dismiss a review for a pull request with an optional message. ### Method POST ### Endpoint /repos/{owner}/{repo}/pulls/{pull_number}/reviews/{review_id}/dismiss ### Parameters #### Path Parameters - **owner** (string) - Required - The owner of the repository. - **repo** (string) - Required - The name of the repository. - **pull_number** (integer) - Required - The number of the pull request. - **review_id** (integer) - Required - The ID of the review to dismiss. #### Request Body - **message** (string) - Optional - The message to accompany the dismissal. ``` ```APIDOC ## merge_pull_request Pull Request ### Description Merge a pull request. ### Method POST ### Endpoint /repos/{owner}/{repo}/pulls/{pull_number}/merge ### Parameters #### Path Parameters - **owner** (string) - Required - The owner of the repository. - **repo** (string) - Required - The name of the repository. - **pull_number** (integer) - Required - The number of the pull request. #### Request Body - **merge_method** (string) - Optional - The merge method to use (e.g., 'merge', 'rebase', 'squash'). Defaults to 'merge'. - **message** (string) - Optional - The commit message for the merge. ``` -------------------------------- ### Organization Operations Source: https://github.com/gitea/gitea-mcp/blob/main/README.md Operations related to organizations, including searching teams and managing labels. ```APIDOC ## search_org_teams Organization ### Description Search for teams within an organization. ### Method GET ### Endpoint /orgs/{org}/teams ### Parameters #### Path Parameters - **org** (string) - Required - The organization's name. #### Query Parameters - **q** (string) - Required - The query string to search for teams. ``` ```APIDOC ## list_org_labels Organization ### Description List labels defined at the organization level. ### Method GET ### Endpoint /orgs/{org}/labels ### Parameters #### Path Parameters - **org** (string) - Required - The organization's name. ``` ```APIDOC ## create_org_label Organization ### Description Create a new label within an organization. ### Method POST ### Endpoint /orgs/{org}/labels ### Parameters #### Path Parameters - **org** (string) - Required - The organization's name. #### Request Body - **name** (string) - Required - The name of the label. - **color** (string) - Required - The color of the label (e.g., '#ff0000'). ``` ```APIDOC ## edit_org_label Organization ### Description Edit an existing label within an organization. ### Method PUT ### Endpoint /orgs/{org}/labels/{id} ### Parameters #### Path Parameters - **org** (string) - Required - The organization's name. - **id** (integer) - Required - The ID of the label to edit. #### Request Body - **name** (string) - Optional - The new name for the label. - **color** (string) - Optional - The new color for the label (e.g., '#00ff00'). ``` ```APIDOC ## delete_org_label Organization ### Description Delete a label from an organization. ### Method DELETE ### Endpoint /orgs/{org}/labels/{id} ### Parameters #### Path Parameters - **org** (string) - Required - The organization's name. - **id** (integer) - Required - The ID of the label to delete. ``` === COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.