@mokoconsulting/mcp-mokogitea-api 1.4.0 → 1.4.1

package/dist/index.js

@@ -1114,14 +1114,22 @@ server.tool('gitea_metadata_update', 'Update repo metadata settings (merges with
     repo: z.string().describe('Repository name'),
     name: z.string().optional().describe('Project name'),
     org: z.string().optional().describe('Organization'),
+    description: z.string().optional().describe('Project description'),
     version: z.string().optional().describe('Version string (e.g. 06.00.00)'),
     version_prefix: z.string().optional().describe('Tag prefix for version display (e.g. v1.26.1-moko.)'),
     license_spdx: z.string().optional().describe('SPDX license identifier'),
+    license_name: z.string().optional().describe('Human-readable license name (e.g. GNU General Public License v3)'),
+    element_name: z.string().optional().describe('Extension element name (e.g. pkg_mokosuitecrm, mod_mokojoomhero)'),
     platform: z.string().optional().describe('Platform (joomla, wordpress, dolibarr, go, mcp, platform, generic)'),
+    standards_version: z.string().optional().describe('mokoplatform standards version (e.g. 05.01.00)'),
+    standards_source: z.string().optional().describe('URL to standards repo'),
+    maintainer: z.string().optional().describe('Maintainer name (e.g. Moko Consulting)'),
+    maintainer_url: z.string().optional().describe('Maintainer website URL'),
     info_url: z.string().optional().describe('Extension info/product page URL'),
-    target_version: z.string().optional().describe('Target platform version regex (e.g. (5|6)\\.*)'),
+    target_version: z.string().optional().describe('Target platform version regex (e.g. 6..*)'),
     php_minimum: z.string().optional().describe('Minimum PHP version (e.g. 8.1)'),
-    package_type: z.string().optional().describe('Extension type (component, module, plugin, package, template, library, file)'),
+    language: z.string().optional().describe('Primary language (e.g. PHP, Go, TypeScript)'),
+    extension_type: z.string().optional().describe('Extension type (component, module, plugin, package, template, library, file)'),
     entry_point: z.string().optional().describe('Build entry point path'),
     ...ConnectionParam,
 }, async ({ owner, repo, connection, ...fields }) => {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@mokoconsulting/mcp-mokogitea-api",
-	"version": "1.4.0",
+	"version": "1.4.1",
 	"description": "MCP server for Gitea REST API v1 operations",
 	"type": "module",
 	"main": "dist/index.js",

package/src/client.ts

@@ -52,7 +52,21 @@ export class GiteaClient {
 	}
 
 	async delete(endpoint: string, body?: unknown): Promise<ApiResponse> {
-		return this.request(this.buildUrl(endpoint), 'DELETE', body);
+		if (body === undefined) {
+			return this.request(this.buildUrl(endpoint), 'DELETE');
+		}
+		// Use fetch for DELETE+body — node:https drops the body on some
+		// proxy/TLS configurations, causing the server to see an empty request.
+		const url = this.buildUrl(endpoint);
+		const resp = await fetch(url, {
+			method: 'DELETE',
+			headers: { ...this.headers },
+			body: JSON.stringify(body),
+		});
+		const raw = await resp.text();
+		let data: unknown;
+		try { data = JSON.parse(raw); } catch { data = raw; }
+		return { status: resp.status, data };
 	}
 
 	private buildUrl(endpoint: string, params?: Record<string, string>): string {

package/src/index.ts

@@ -1720,14 +1720,22 @@ server.tool(
 		repo: z.string().describe('Repository name'),
 		name: z.string().optional().describe('Project name'),
 		org: z.string().optional().describe('Organization'),
+		description: z.string().optional().describe('Project description'),
 		version: z.string().optional().describe('Version string (e.g. 06.00.00)'),
 		version_prefix: z.string().optional().describe('Tag prefix for version display (e.g. v1.26.1-moko.)'),
 		license_spdx: z.string().optional().describe('SPDX license identifier'),
+		license_name: z.string().optional().describe('Human-readable license name (e.g. GNU General Public License v3)'),
+		element_name: z.string().optional().describe('Extension element name (e.g. pkg_mokosuitecrm, mod_mokojoomhero)'),
 		platform: z.string().optional().describe('Platform (joomla, wordpress, dolibarr, go, mcp, platform, generic)'),
+		standards_version: z.string().optional().describe('mokoplatform standards version (e.g. 05.01.00)'),
+		standards_source: z.string().optional().describe('URL to standards repo'),
+		maintainer: z.string().optional().describe('Maintainer name (e.g. Moko Consulting)'),
+		maintainer_url: z.string().optional().describe('Maintainer website URL'),
 		info_url: z.string().optional().describe('Extension info/product page URL'),
-		target_version: z.string().optional().describe('Target platform version regex (e.g. (5|6)\\.*)'),
+		target_version: z.string().optional().describe('Target platform version regex (e.g. 6..*)'),
 		php_minimum: z.string().optional().describe('Minimum PHP version (e.g. 8.1)'),
-		package_type: z.string().optional().describe('Extension type (component, module, plugin, package, template, library, file)'),
+		language: z.string().optional().describe('Primary language (e.g. PHP, Go, TypeScript)'),
+		extension_type: z.string().optional().describe('Extension type (component, module, plugin, package, template, library, file)'),
 		entry_point: z.string().optional().describe('Build entry point path'),
 		...ConnectionParam,
 	},

package/Dockerfile

@@ -1,18 +0,0 @@
-FROM node:20-alpine
-
-WORKDIR /app
-
-COPY package.json package-lock.json ./
-RUN npm ci --production=false
-
-COPY tsconfig.json ./
-COPY src/ ./src/
-RUN npx tsc && npm prune --production
-
-EXPOSE 3100
-
-ENV PORT=3100
-ENV NODE_ENV=production
-
-# SSE mode by default for Docker deployments
-CMD ["node", "dist/sse.js"]

package/dist/server.d.ts

@@ -1,4 +0,0 @@
-import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import type { GiteaConfig } from './types.js';
-export declare function createMcpServer(cfg: GiteaConfig): McpServer;
-//# sourceMappingURL=server.d.ts.map

package/dist/server.js

@@ -1,12 +0,0 @@
-// Copyright 2026 Moko Consulting <hello@mokoconsulting.tech>
-// SPDX-License-Identifier: GPL-3.0-or-later
-//
-// Creates a configured MCP server instance for use by both stdio and SSE transports.
-// Import index.ts to register all tools on its exported `server` singleton,
-// then re-export a factory that initializes config and returns the server.
-import { server, initConfig } from './index.js';
-export function createMcpServer(cfg) {
-    initConfig(cfg);
-    return server;
-}
-//# sourceMappingURL=server.js.map

package/dist/sse.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=sse.d.ts.map

package/dist/sse.js

@@ -1,87 +0,0 @@
-// Copyright 2026 Moko Consulting <hello@mokoconsulting.tech>
-// SPDX-License-Identifier: GPL-3.0-or-later
-//
-// SSE transport entry point for MokoGitea MCP server.
-// Run with: node dist/sse.js
-// Or: GITEA_URL=https://gitea.example.com GITEA_TOKEN=xxx node dist/sse.js
-//
-// Listens on PORT (default 3100) and serves SSE at /sse with POST at /message.
-import { createServer } from 'node:http';
-import { SSEServerTransport } from '@modelcontextprotocol/sdk/server/sse.js';
-import { createMcpServer } from './server.js';
-import { loadConfig } from './config.js';
-const PORT = parseInt(process.env.PORT ?? '3100', 10);
-async function main() {
-    const config = await loadConfig();
-    const transports = new Map();
-    const httpServer = createServer(async (req, res) => {
-        // CORS headers for browser clients
-        res.setHeader('Access-Control-Allow-Origin', '*');
-        res.setHeader('Access-Control-Allow-Methods', 'GET, POST, OPTIONS');
-        res.setHeader('Access-Control-Allow-Headers', 'Content-Type, Authorization');
-        if (req.method === 'OPTIONS') {
-            res.writeHead(204);
-            res.end();
-            return;
-        }
-        // Health check
-        if (req.url === '/health') {
-            res.writeHead(200, { 'Content-Type': 'application/json' });
-            res.end(JSON.stringify({ status: 'ok', tools: 120 }));
-            return;
-        }
-        // SSE endpoint - client connects here
-        if (req.url === '/sse' && req.method === 'GET') {
-            const transport = new SSEServerTransport('/message', res);
-            const sessionId = transport.sessionId;
-            transports.set(sessionId, transport);
-            const server = createMcpServer(config);
-            await server.connect(transport);
-            req.on('close', () => {
-                transports.delete(sessionId);
-            });
-            return;
-        }
-        // Message endpoint - client sends tool calls here
-        if (req.url?.startsWith('/message') && req.method === 'POST') {
-            const url = new URL(req.url, `http://${req.headers.host}`);
-            const sessionId = url.searchParams.get('sessionId');
-            if (!sessionId || !transports.has(sessionId)) {
-                res.writeHead(400, { 'Content-Type': 'application/json' });
-                res.end(JSON.stringify({ error: 'Invalid or missing sessionId' }));
-                return;
-            }
-            const transport = transports.get(sessionId);
-            await transport.handlePostMessage(req, res);
-            return;
-        }
-        // Root - info page
-        if (req.url === '/' || req.url === '') {
-            res.writeHead(200, { 'Content-Type': 'application/json' });
-            res.end(JSON.stringify({
-                name: '@mokoconsulting/mokogitea-mcp',
-                version: '1.1.0',
-                description: 'MCP server for Gitea and MokoGitea - 120+ tools',
-                endpoints: {
-                    sse: '/sse',
-                    message: '/message',
-                    health: '/health',
-                },
-                docs: 'https://git.mokoconsulting.tech/MokoConsulting/mcp_mokogitea_api',
-            }));
-            return;
-        }
-        res.writeHead(404);
-        res.end('Not found');
-    });
-    httpServer.listen(PORT, () => {
-        process.stderr.write(`MokoGitea MCP SSE server listening on port ${PORT}\n`);
-        process.stderr.write(`  SSE: http://localhost:${PORT}/sse\n`);
-        process.stderr.write(`  Health: http://localhost:${PORT}/health\n`);
-    });
-}
-main().catch((err) => {
-    process.stderr.write(`Fatal: ${err}\n`);
-    process.exit(1);
-});
-//# sourceMappingURL=sse.js.map

package/src/server.ts

@@ -1,16 +0,0 @@
-// Copyright 2026 Moko Consulting <hello@mokoconsulting.tech>
-// SPDX-License-Identifier: GPL-3.0-or-later
-//
-// Creates a configured MCP server instance for use by both stdio and SSE transports.
-
-import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import type { GiteaConfig } from './types.js';
-
-// Import index.ts to register all tools on its exported `server` singleton,
-// then re-export a factory that initializes config and returns the server.
-import { server, initConfig } from './index.js';
-
-export function createMcpServer(cfg: GiteaConfig): McpServer {
-	initConfig(cfg);
-	return server;
-}

package/src/sse.ts

@@ -1,100 +0,0 @@
-// Copyright 2026 Moko Consulting <hello@mokoconsulting.tech>
-// SPDX-License-Identifier: GPL-3.0-or-later
-//
-// SSE transport entry point for MokoGitea MCP server.
-// Run with: node dist/sse.js
-// Or: GITEA_URL=https://gitea.example.com GITEA_TOKEN=xxx node dist/sse.js
-//
-// Listens on PORT (default 3100) and serves SSE at /sse with POST at /message.
-
-import { createServer } from 'node:http';
-import { SSEServerTransport } from '@modelcontextprotocol/sdk/server/sse.js';
-import { createMcpServer } from './server.js';
-import { loadConfig } from './config.js';
-
-const PORT = parseInt(process.env.PORT ?? '3100', 10);
-
-async function main(): Promise<void> {
-	const config = await loadConfig();
-	const transports = new Map<string, SSEServerTransport>();
-
-	const httpServer = createServer(async (req, res) => {
-		// CORS headers for browser clients
-		res.setHeader('Access-Control-Allow-Origin', '*');
-		res.setHeader('Access-Control-Allow-Methods', 'GET, POST, OPTIONS');
-		res.setHeader('Access-Control-Allow-Headers', 'Content-Type, Authorization');
-
-		if (req.method === 'OPTIONS') {
-			res.writeHead(204);
-			res.end();
-			return;
-		}
-
-		// Health check
-		if (req.url === '/health') {
-			res.writeHead(200, { 'Content-Type': 'application/json' });
-			res.end(JSON.stringify({ status: 'ok', tools: 120 }));
-			return;
-		}
-
-		// SSE endpoint - client connects here
-		if (req.url === '/sse' && req.method === 'GET') {
-			const transport = new SSEServerTransport('/message', res);
-			const sessionId = transport.sessionId;
-			transports.set(sessionId, transport);
-
-			const server = createMcpServer(config);
-			await server.connect(transport);
-
-			req.on('close', () => {
-				transports.delete(sessionId);
-			});
-			return;
-		}
-
-		// Message endpoint - client sends tool calls here
-		if (req.url?.startsWith('/message') && req.method === 'POST') {
-			const url = new URL(req.url, `http://${req.headers.host}`);
-			const sessionId = url.searchParams.get('sessionId');
-			if (!sessionId || !transports.has(sessionId)) {
-				res.writeHead(400, { 'Content-Type': 'application/json' });
-				res.end(JSON.stringify({ error: 'Invalid or missing sessionId' }));
-				return;
-			}
-			const transport = transports.get(sessionId)!;
-			await transport.handlePostMessage(req, res);
-			return;
-		}
-
-		// Root - info page
-		if (req.url === '/' || req.url === '') {
-			res.writeHead(200, { 'Content-Type': 'application/json' });
-			res.end(JSON.stringify({
-				name: '@mokoconsulting/mokogitea-mcp',
-				version: '1.1.0',
-				description: 'MCP server for Gitea and MokoGitea - 120+ tools',
-				endpoints: {
-					sse: '/sse',
-					message: '/message',
-					health: '/health',
-				},
-				docs: 'https://git.mokoconsulting.tech/MokoConsulting/mcp_mokogitea_api',
-			}));
-			return;
-		}
-
-		res.writeHead(404);
-		res.end('Not found');
-	});
-
-	httpServer.listen(PORT, () => {
-		process.stderr.write(`MokoGitea MCP SSE server listening on port ${PORT}\n`);
-		process.stderr.write(`  SSE: http://localhost:${PORT}/sse\n`);
-		process.stderr.write(`  Health: http://localhost:${PORT}/health\n`);
-	});
-}
-
-main().catch((err) => {
-	process.stderr.write(`Fatal: ${err}\n`);
-	process.exit(1);
-});

package/wiki/ARCHITECTURE.md

@@ -1,144 +0,0 @@
-← [Home](Home)
-
-# Architecture
-
-## Component Overview
-
-```
-src/
-  index.ts    -- MCP server entry point, tool registrations (61 tools)
-  client.ts   -- HTTP client for Gitea REST API v1
-  config.ts   -- Configuration loader (multi-connection support)
-  types.ts    -- TypeScript type definitions
-```
-
-### index.ts -- Server Entry Point
-
-The main module that:
-
-- Creates the `McpServer` instance with stdio transport
-- Loads configuration on startup via `loadConfig()`
-- Registers all 61 tools organized by category
-- Provides shared parameter schemas (`OwnerRepo`, `PaginationParams`, `ConnectionParam`)
-- Routes tool calls through `clientFor(connection)` to resolve the target Gitea instance
-- Formats all API responses through `formatResponse()` for consistent MCP output
-
-### client.ts -- HTTP Client
-
-`GiteaClient` is a zero-dependency HTTP client built on `node:https` and `node:http`:
-
-- Prepends `/api/v1` to all endpoint paths
-- Sets `Authorization: token <token>` header on every request (Gitea's native auth format)
-- Supports `GET`, `POST`, `PUT`, `PATCH`, `DELETE` methods
-- Handles query parameter construction via `URL.searchParams`
-- Parses JSON responses automatically
-- 30-second request timeout
-- Optional TLS certificate verification bypass (`insecure` flag)
-
-### config.ts -- Configuration Loader
-
-Loads the connection configuration from disk:
-
-- Default path: `~/.gitea-api-mcp.json`
-- Override via `GITEA_API_MCP_CONFIG` environment variable
-- Validates that at least one connection exists
-- Sets `defaultConnection` to the first connection if not explicitly specified
-- `getConnection()` resolves a named connection or falls back to the default
-
-### types.ts -- Type Definitions
-
-Three core interfaces:
-
-- `GiteaConnection` -- Single connection config (`baseUrl`, `token`, `insecure?`)
-- `GiteaConfig` -- Full config with named connections map and default
-- `ApiResponse` -- Standardized response wrapper (`status`, `data`)
-
-## Design Decisions
-
-### Token Authentication
-
-Gitea uses `Authorization: token <access-token>` as its native authentication header format, unlike GitHub's `Bearer` token format. This server uses the native Gitea format directly, ensuring compatibility with all Gitea versions without requiring OAuth2 setup.
-
-### Multi-Connection Architecture
-
-Every tool accepts an optional `connection` parameter. This enables:
-
-- Managing multiple Gitea instances from a single MCP server
-- Switching between production, staging, and development instances
-- Cross-instance operations within a single Claude Code session
-
-The connection is resolved at call time, not at startup, so different tool calls can target different instances.
-
-### node:https (Zero HTTP Dependencies)
-
-The HTTP client uses Node.js built-in `node:https` and `node:http` modules instead of third-party libraries (e.g., axios, node-fetch). This decision:
-
-- Eliminates supply-chain risk from HTTP client dependencies
-- Reduces `node_modules` size
-- Avoids compatibility issues across Node.js versions
-- Provides full control over TLS configuration (needed for `insecure` flag)
-
-### Stdio Transport
-
-The MCP server uses stdio transport (stdin/stdout) rather than HTTP/SSE. This means:
-
-- No network ports are opened by the server
-- Tokens are never exposed through HTTP endpoints
-- The server runs as a child process of the MCP client
-- Communication is process-local, reducing attack surface
-
-### Shared Parameter Objects
-
-Common parameter patterns are defined as reusable objects:
-
-- `OwnerRepo` -- `{ owner, repo }` for all repository-scoped operations
-- `PaginationParams` -- `{ page, limit }` for all list endpoints
-- `ConnectionParam` -- `{ connection }` for multi-connection routing
-
-This ensures consistency across all 61 tools and simplifies adding new tools.
-
-## Data Flow
-
-```
-                        +-----------------+
-                        |  Claude Code /  |
-                        |  MCP Client     |
-                        +--------+--------+
-                                 |
-                            stdio (JSON-RPC)
-                                 |
-                        +--------v--------+
-                        |  index.ts       |
-                        |  McpServer      |
-                        |  (tool router)  |
-                        +--------+--------+
-                                 |
-                     +-----------+-----------+
-                     |                       |
-              +------v------+        +-------v-------+
-              |  config.ts  |        |  client.ts    |
-              |  loadConfig |        |  GiteaClient  |
-              |  getConn    |        |  (HTTP calls) |
-              +------+------+        +-------+-------+
-                     |                        |
-              +------v------+         HTTPS / HTTP
-              | ~/.gitea-   |                 |
-              | api-mcp.json|        +--------v--------+
-              +-------------+        |  Gitea Instance |
-                                     |  /api/v1/*      |
-                                     +-----------------+
-```
-
-1. Claude Code sends a JSON-RPC tool call over stdio
-2. `McpServer` routes the call to the registered tool handler
-3. The handler calls `clientFor(connection)` which resolves the connection from config
-4. `GiteaClient` constructs the HTTP request and sends it to the Gitea API
-5. The JSON response is wrapped in `formatResponse()` and returned to the MCP client
-
----
-
-*Repo: [gitea-api-mcp](https://git.mokoconsulting.tech/MokoConsulting/gitea-api-mcp) . [MokoStandards](https://git.mokoconsulting.tech/MokoConsulting/mokoplatform/wiki/Home)*
-
-| Revision | Date | Author | Description |
-|---|---|---|---|
-| 1.0 | 2026-05-09 | Moko Consulting | Initial version |

package/wiki/Home.md

@@ -1,35 +0,0 @@
-# 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
-
-| Field | Value |
-|---|---|
-| **Language** | Markdown |
-| **License** | GPL-3.0-or-later |
-| **Platform** | [Gitea](https://git.mokoconsulting.tech/MokoConsulting/gitea-api-mcp) |
-
----
-
-## Guides
-
-| Page | Description |
-|---|---|
-| [INSTALLATION](INSTALLATION) | - **Node.js** >= 20.0.0 ([download](https://nodejs.org)) |
-
-## Reference
-
-| Page | Description |
-|---|---|
-| [ARCHITECTURE](ARCHITECTURE) | index.ts    -- MCP server entry point, tool registrations (61 tools) |
-
----
-
-> [MokoStandards](https://git.mokoconsulting.tech/MokoConsulting/mokoplatform/wiki/Home)
-
----
-
-*Repo: [gitea-api-mcp](https://git.mokoconsulting.tech/MokoConsulting/gitea-api-mcp) . [MokoStandards](https://git.mokoconsulting.tech/MokoConsulting/mokoplatform/wiki/Home)*
-
-| Revision | Date | Author | Description |
-|---|---|---|---|
-| 1.0 | 2026-05-09 | Moko Consulting | Initial version |