diff --git a/.mokogitea/ISSUE_TEMPLATE/config.yml b/.mokogitea/ISSUE_TEMPLATE/config.yml index d4d49ec..71fe271 100644 --- a/.mokogitea/ISSUE_TEMPLATE/config.yml +++ b/.mokogitea/ISSUE_TEMPLATE/config.yml @@ -8,7 +8,7 @@ contact_links: url: https://mokoconsulting.tech/ about: Get help or ask questions through our website - name: πŸ“š MokoStandards Documentation - url: https://git.mokoconsulting.tech/MokoConsulting/moko-platform + url: https://git.mokoconsulting.tech/MokoConsulting/.mokogitea/wiki about: View our coding standards and best practices - name: πŸ”’ Report a Security Vulnerability url: https://git.mokoconsulting.tech/mokoconsulting-tech/.github-private/security/advisories/new diff --git a/.mokogitea/ISSUE_TEMPLATE/feature_request.md b/.mokogitea/ISSUE_TEMPLATE/feature_request.md index 7b76dc9..984fcbe 100644 --- a/.mokogitea/ISSUE_TEMPLATE/feature_request.md +++ b/.mokogitea/ISSUE_TEMPLATE/feature_request.md @@ -37,7 +37,7 @@ If you have ideas about how this could be implemented, share them here: Add any other context, mockups, or screenshots about the feature request here. ## Relevant Standards -Does this relate to any standards in [MokoStandards](https://git.mokoconsulting.tech/MokoConsulting/MokoStandards)? +Does this relate to any standards in [MokoStandards](https://git.mokoconsulting.tech/MokoConsulting/.mokogitea/wiki)? - [ ] Accessibility (WCAG 2.1 AA) - [ ] Localization (en_US/en_GB) - [ ] Security best practices diff --git a/.mokogitea/ISSUE_TEMPLATE/mcp_connection_issue.md b/.mokogitea/ISSUE_TEMPLATE/mcp_connection_issue.md index 2be863b..841decb 100644 --- a/.mokogitea/ISSUE_TEMPLATE/mcp_connection_issue.md +++ b/.mokogitea/ISSUE_TEMPLATE/mcp_connection_issue.md @@ -18,7 +18,7 @@ assignees: '' - [ ] API response error (4xx / 5xx) ### MCP Server -- **Server Name**: [e.g., mcp_mokowaas] +- **Server Name**: [e.g., mcp_mokosuite] - **Server Version**: [e.g., 1.0.0] - **Node.js Version**: [e.g., 20.x] diff --git a/.mokogitea/ISSUE_TEMPLATE/security.md b/.mokogitea/ISSUE_TEMPLATE/security.md index f57b284..14d63e0 100644 --- a/.mokogitea/ISSUE_TEMPLATE/security.md +++ b/.mokogitea/ISSUE_TEMPLATE/security.md @@ -35,7 +35,7 @@ Use this template only for: ## Standards Reference -Does this relate to security standards in [MokoStandards](https://git.mokoconsulting.tech/MokoConsulting/MokoStandards)? +Does this relate to security standards in [MokoStandards](https://git.mokoconsulting.tech/MokoConsulting/.mokogitea/wiki)? - [ ] SPDX license identifiers - [ ] Secret management - [ ] Dependency security diff --git a/CHANGELOG.md b/CHANGELOG.md index 9e126fc..8f1c09f 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -31,7 +31,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0 - `branch-cleanup.yml`: auto-delete merged feature branches after PR merge ### Changed -- **Renamed** package from `@mokoconsulting/gitea-api-mcp` to `@mokoconsulting/mokogitea-api-mcp` to distinguish Moko's forked Gitea MCP from upstream +- **Renamed** package from `@mokoconsulting/gitea-api-mcp` to `@mokoconsulting/mokogitea-api-mcp` to distinguish Moko's forked MokoGitea MCP from upstream - **Renamed** McpServer name and bin entry to `mokogitea-api-mcp` ## [0.0.1] - 2026-05-07 @@ -51,7 +51,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0 - `gitea_repo_fork` -- Fork a repository - `gitea_repo_search` -- Search repositories - `gitea_org_repos` -- List repositories in an organization -- `gitea_list_connections` -- List configured Gitea connections +- `gitea_list_connections` -- List configured MokoGitea connections #### File Contents (5 tools) - `gitea_file_get` -- Get file contents from a repository @@ -133,12 +133,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0 - `gitea_notifications_read` -- Mark all notifications as read #### Generic (2 tools) -- `gitea_api_request` -- Make a raw API request to any Gitea v1 endpoint -- `gitea_list_connections` -- List configured Gitea connections +- `gitea_api_request` -- Make a raw API request to any MokoGitea v1 endpoint +- `gitea_list_connections` -- List configured MokoGitea connections ### Infrastructure - Multi-connection config support via `~/.gitea-api-mcp.json` -- Token-based authentication (Gitea native `Authorization: token` header) +- Token-based authentication (MokoGitea native `Authorization: token` header) - Built on `node:https` / `node:http` (zero HTTP dependencies) - MCP SDK v1.12.x with stdio transport diff --git a/CLAUDE.md b/CLAUDE.md index b31f02e..5660389 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -4,7 +4,7 @@ This file provides guidance to Claude Code when working with this repository. ## Project Overview -**gitea-api-mcp** -- MCP server for Gitea REST API v1 operations β€” 61 tools for repos, issues, PRs, releases, branches, actions, orgs, wiki, webhooks, and more +**gitea-api-mcp** -- MCP server for MokoGitea REST API v1 operations β€” 61 tools for repos, issues, PRs, releases, branches, actions, orgs, wiki, webhooks, and more | Field | Value | |---|---| @@ -13,7 +13,7 @@ This file provides guidance to Claude Code when working with this repository. | **Default branch** | main | | **License** | GPL-3.0-or-later | | **Wiki** | [gitea-api-mcp Wiki](https://git.mokoconsulting.tech/MokoConsulting/gitea-api-mcp/wiki) | -| **Standards** | [MokoStandards](https://git.mokoconsulting.tech/MokoConsulting/moko-platform/wiki/Home) | +| **Standards** | [MokoStandards](https://git.mokoconsulting.tech/MokoConsulting/.mokogitea/wiki) | ## Common Commands @@ -39,5 +39,5 @@ This is an MCP (Model Context Protocol) server. Key files: - **Attribution**: use `Authored-by: Moko Consulting` in commits - **Branch strategy**: develop on `dev`, merge to `main` for release - **Minification**: handled at build time (CI) and runtime (MokoMinifyHelper for Joomla templates) -- **Wiki**: documentation lives in the Gitea wiki, not in `docs/` files -- **Standards**: this repo follows [MokoStandards](https://git.mokoconsulting.tech/MokoConsulting/moko-platform/wiki/Home) +- **Wiki**: documentation lives in the MokoGitea wiki, not in `docs/` files +- **Standards**: this repo follows [MokoStandards](https://git.mokoconsulting.tech/MokoConsulting/.mokogitea/wiki) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index bf60cc5..73f36d9 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -34,7 +34,7 @@ feature/* ──PR──> dev ──draft PR──> (renamed to rc) ──merge 7. **Merging to main** triggers the stable release pipeline: - Minor version bump (e.g., `02.09.xx` β†’ `02.10.00`) - Stability suffix stripped (clean version) - - Gitea release created with ZIP/tar.gz packages + - MokoGitea release created with ZIP/tar.gz packages - `updates.xml` updated (Joomla extensions) - `dev` branch recreated from `main` diff --git a/README.md b/README.md index 7cfc1c0..05a1930 100644 --- a/README.md +++ b/README.md @@ -11,7 +11,7 @@ REPO: https://git.mokoconsulting.tech/MokoConsulting/gitea-api-mcp [![Node](https://img.shields.io/badge/node-%3E%3D20.0.0-green.svg)](https://nodejs.org) [![TypeScript](https://img.shields.io/badge/TypeScript-5.x-blue.svg)](https://www.typescriptlang.org) -> MCP server for Gitea REST API v1 operations -- 111 tools for complete Gitea instance management from Claude Code and other MCP clients. +> MCP server for MokoGitea REST API v1 operations -- 111 tools for complete MokoGitea instance management from Claude Code and other MCP clients. ## Table of Contents @@ -26,15 +26,15 @@ REPO: https://git.mokoconsulting.tech/MokoConsulting/gitea-api-mcp ## Background -`gitea-api-mcp` is a Model Context Protocol (MCP) server that exposes 111 tools for interacting with the Gitea REST API v1. It supports multiple named connections, allowing you to manage several Gitea instances from a single server. Authentication uses Gitea's native `Authorization: token` header format. +`gitea-api-mcp` is a Model Context Protocol (MCP) server that exposes 111 tools for interacting with the MokoGitea REST API v1. It supports multiple named connections, allowing you to manage several MokoGitea instances from a single server. Authentication uses MokoGitea's native `Authorization: token` header format. ## Install ### Prerequisites - Node.js >= 20.0.0 -- A Gitea instance with API access -- A Gitea access token (Settings > Applications > Generate Token) +- A MokoGitea instance with API access +- A MokoGitea access token (Settings > Applications > Generate Token) ### Build from Source @@ -66,8 +66,8 @@ Create `~/.gitea-api-mcp.json`: | Field | Type | Required | Description | |-------|------|----------|-------------| -| `baseUrl` | string | Yes | Base URL of your Gitea instance | -| `token` | string | Yes | Gitea API access token | +| `baseUrl` | string | Yes | Base URL of your MokoGitea instance | +| `token` | string | Yes | MokoGitea API access token | | `insecure` | boolean | No | Skip TLS verification (self-signed certs) | Override the config path with the `GITEA_API_MCP_CONFIG` environment variable. @@ -138,7 +138,7 @@ If `connection` is omitted, the `defaultConnection` is used. | `gitea_repo_fork` | Fork a repository | | `gitea_repo_search` | Search repositories | | `gitea_org_repos` | List repositories in an organization | -| `gitea_list_connections` | List configured Gitea connections | +| `gitea_list_connections` | List configured MokoGitea connections | ### File Contents (5 tools) @@ -273,8 +273,8 @@ If `connection` is omitted, the `defaultConnection` is used. | Tool | Description | |------|-------------| -| `gitea_api_request` | Make a raw API request to any Gitea v1 endpoint | -| `gitea_list_connections` | List configured Gitea connections | +| `gitea_api_request` | Make a raw API request to any MokoGitea v1 endpoint | +| `gitea_list_connections` | List configured MokoGitea connections | ## Contributing diff --git a/SECURITY.md b/SECURITY.md index f6032e8..e8fb5ad 100644 --- a/SECURITY.md +++ b/SECURITY.md @@ -22,7 +22,7 @@ We will acknowledge receipt within 48 hours and provide an initial assessment wi ### Configuration File -The config file `~/.gitea-api-mcp.json` stores Gitea API tokens in plaintext. Follow these practices to protect your tokens: +The config file `~/.gitea-api-mcp.json` stores MokoGitea API tokens in plaintext. Follow these practices to protect your tokens: #### File Permissions @@ -43,7 +43,7 @@ On Windows, ensure the file is only readable by your user account through the fi #### Token Scope -When generating Gitea access tokens, follow the principle of least privilege: +When generating MokoGitea access tokens, follow the principle of least privilege: - Only grant the scopes (permissions) your workflow requires - Use separate tokens for separate purposes or environments @@ -52,7 +52,7 @@ When generating Gitea access tokens, follow the principle of least privilege: #### Token Generation -1. Navigate to your Gitea instance Settings > Applications +1. Navigate to your MokoGitea instance Settings > Applications 2. Under "Manage Access Tokens," enter a token name 3. Select only the required scopes 4. Click "Generate Token"