gitwalter FastAPI Backend & MCP Infrastructure
This skill manages the local API services that connect the Next.js visual frontend with Python CLI backend scripts, coordinates local MCP servers, and integrates with external package managers (npm, pypi, github).
When to Use
Use this skill when modifying the Next.js API endpoints, building custom MCP servers (like the RAG mcp server), running the workspace email automation, or adding npm/pypi metadata adapters.
Prerequisites
- Conda environment setup.
- Node.js environment configured (for js-based adapters).
Process
Follow these procedures to launch API endpoints and test MCP routing.
Launching the Backend API Server
Start the local FastAPI service on port 8000:
conda run -p D:\Anaconda\envs\cursor-factory python scripts/api/mcp_api.py
Running MCP client scripts
Search local indices or verify server logs:
conda run -p D:\Anaconda\envs\cursor-factory python scripts/mcp_infra/search_client.py
Best Practices
- Graceful Shutdown: Always handle server SIGINT signals properly to release system ports.
- Port Reuse: Check and terminate processes occupying port 8000 before launching the FastAPI script.