idx-api-orchestration

name	idx-api-orchestration
description	FastAPI backend orchestration, MCP infrastructure servers/clients, and community integrations.
type	skill
version	1.0.0
category	routing
agents	["python-ai-specialist","master-system-orchestrator"]
knowledge	["api-integration-patterns.json"]
scripts	["scripts/api/llm_config.py","scripts/api/mcp-api.py","scripts/api/mcp_api.py","scripts/api/workflow_service.py","scripts/mcp_infra/adapters/doc_tools.js","scripts/mcp_infra/list_sources_client.py","scripts/mcp_infra/scripts/find_contact_email.py","scripts/mcp_infra/scripts/mcp_server_automation.py","scripts/mcp_infra/scripts/send_draft_email.py","scripts/mcp_infra/scripts/send_gmail.py","scripts/mcp_infra/search_client.py","scripts/mcp_infra/servers/rag/rag_mcp_server.py","scripts/adapters/base_adapter.py","scripts/adapters/community_adapter.py","scripts/adapters/docs_adapter.py","scripts/adapters/feedback_adapter.py","scripts/adapters/github_adapter.py","scripts/adapters/npm_adapter.py","scripts/adapters/pypi_adapter.py"]
tools	[]
related_skills	["orchestrating-mcp"]
references	[]
settings	{"auto_approve":false,"timeout_seconds":300}

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.