[Diagnostic] Gitea MCP Tools Not Available - Missing .mcp.json in projman 3.3.0 #355

New Issue

lmiranda · 2026-02-01T19:58:44Z

lmiranda commented

2026-02-01 19:58:44 +00:00

Diagnostic Report: Gitea MCP Tools Not Available

Generated: 2026-02-01
Source: personal-projects/personal-portfolio (Sprint 10)
Agent: Claude Opus 4.5

Environment Status

Component	Status	Details
gitea.env config	MISSING	`~/.config/claude/gitea.env` not found
Gitea MCP venv	MISSING	`~/.cache/claude-mcp-venvs/leo-claude-mktplace/gitea/.venv` not installed
projman .mcp.json	MISSING	Version 3.3.0 lacks MCP server registration (regression from 3.2.0)

Tool Test Results

Tool	Available	Status
validate_repo_org	NO	NOT_AVAILABLE
get_labels	NO	NOT_AVAILABLE
list_issues	NO	NOT_AVAILABLE
list_milestones	NO	NOT_AVAILABLE
suggest_labels	NO	NOT_AVAILABLE

Result: 0/5 tests passed

Root Cause Analysis

Regression in projman 3.3.0: The .mcp.json file that registers the Gitea MCP server is missing from version 3.3.0 but was present in 3.2.0.

Missing system configuration: Users need ~/.config/claude/gitea.env with:

GITEA_API_URL=https://gitea.hotserv.cloud/api/v1
GITEA_API_TOKEN=<token>

Missing venv installation: The Gitea MCP server requires its Python dependencies installed.

Hypothesis

The plugin update from 3.2.0 to 3.3.0 inadvertently removed the .mcp.json file, causing MCP server registration to fail silently. This explains why Gitea tools worked previously but stopped after the update.

Impact

Cannot create/close Gitea issues programmatically
Cannot fetch labels or milestones
Sprint planning/closing requires manual Gitea interaction
Workaround: Manual issue management via browser or direct API calls

Suggested Fix

Add .mcp.json to projman plugin:

{
  "mcpServers": {
    "gitea": {
      "command": "${CLAUDE_PLUGIN_ROOT}/mcp-servers/gitea/run.sh",
      "args": []
    }
  }
}

Labels: Type: Bug Source: Diagnostic Agent: Claude Plugin: projman Component: MCP

## Diagnostic Report: Gitea MCP Tools Not Available **Generated:** 2026-02-01 **Source:** personal-projects/personal-portfolio (Sprint 10) **Agent:** Claude Opus 4.5 --- ### Environment Status | Component | Status | Details | |-----------|--------|--------| | gitea.env config | MISSING | `~/.config/claude/gitea.env` not found | | Gitea MCP venv | MISSING | `~/.cache/claude-mcp-venvs/leo-claude-mktplace/gitea/.venv` not installed | | projman .mcp.json | **MISSING** | Version 3.3.0 lacks MCP server registration (regression from 3.2.0) | ### Tool Test Results | Tool | Available | Status | |------|-----------|--------| | validate_repo_org | NO | NOT_AVAILABLE | | get_labels | NO | NOT_AVAILABLE | | list_issues | NO | NOT_AVAILABLE | | list_milestones | NO | NOT_AVAILABLE | | suggest_labels | NO | NOT_AVAILABLE | **Result:** 0/5 tests passed --- ### Root Cause Analysis 1. **Regression in projman 3.3.0**: The `.mcp.json` file that registers the Gitea MCP server is missing from version 3.3.0 but was present in 3.2.0. 2. **Missing system configuration**: Users need `~/.config/claude/gitea.env` with: ``` GITEA_API_URL=https://gitea.hotserv.cloud/api/v1 GITEA_API_TOKEN=<token> ``` 3. **Missing venv installation**: The Gitea MCP server requires its Python dependencies installed. --- ### Hypothesis The plugin update from 3.2.0 to 3.3.0 inadvertently removed the `.mcp.json` file, causing MCP server registration to fail silently. This explains why Gitea tools worked previously but stopped after the update. ### Impact - Cannot create/close Gitea issues programmatically - Cannot fetch labels or milestones - Sprint planning/closing requires manual Gitea interaction - Workaround: Manual issue management via browser or direct API calls --- ### Suggested Fix Add `.mcp.json` to projman plugin: ```json { "mcpServers": { "gitea": { "command": "${CLAUDE_PLUGIN_ROOT}/mcp-servers/gitea/run.sh", "args": [] } } } ``` --- **Labels:** `Type: Bug` `Source: Diagnostic` `Agent: Claude` `Plugin: projman` `Component: MCP`

lmiranda closed this issue

2026-02-01 20:54:57 +00:00

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: personal-projects/leo-claude-mktplace#355