mcp-management

[IMPORTANT] Use TaskCreate to break ALL work into small tasks BEFORE starting — including tasks for each file read. This prevents context loss from long files. For simple tasks, AI MUST ATTENTION ask user whether to skip.

Quick Summary

Goal: Discover, analyze, and execute MCP tools/prompts/resources from configured servers without polluting main context.

Workflow:

1. Config Management — Use .claude/.mcp.json, symlink to .gemini/settings.json for Gemini CLI
2. Capability Discovery — npx tsx scripts/cli.ts list-tools saves to assets/tools.json
3. Intelligent Selection — LLM analyzes tools.json for task-relevant capabilities
4. Execution — Primary: Gemini CLI with stdin piping; Secondary: Direct scripts; Fallback: general-purpose subagent

Key Rules:

• Gemini CLI Primary: Use stdin piping (echo "task" | gemini), NOT -p flag (skips MCP init)
• GEMINI.md Auto-Load: Project root file enforces structured JSON responses from Gemini
• Progressive Disclosure: Load only needed capabilities, subagents handle discovery
• Persistent Catalog: list-tools saves complete schemas to assets/tools.json for fast reference