miniOrange MCP Server

This is a Model Context Protocol (MCP) server that provides setup guides and walkthroughs for miniOrange services to IDE agents like Cursor and Antigravity.

Setup

1. Install Dependencies:

   pip install -r requirements.txt
   

2. Scrape Documentation (Optional): The docs_index.json is generated by scraping the miniOrange developer docs.

   python scraper.py
   

Running the Server

Start the MCP server using Uvicorn:

uvicorn server:app --reload --port 8000

The server will be available at http://localhost:8000.

Connecting to Cursor

1. Open Cursor Settings -> Features -> MCP.
2. Click Add new MCP server.
3. Enter the Name (e.g., "miniOrange MCP").
4. Enter the URL: http://localhost:8000/tools (Note: Cursor might expect the full SSE or tool endpoint, but for HTTP based MCP, usually pointing to the tools definitions helps, or follow specific Cursor MCP docs. Actually, standard MCP uses stdio or SSE. This server exposes HTTP endpoints that an agent can call as tools if configured manually or via an HTTP-to-MCP bridge. This implementation follows the user's request for a FastAPI server.)

Usage

When connected, you can ask your agent:

• "How do I set up miniOrange OAuth?"
• "Give me a walkthrough for SAML setup."

The agent will use the get_miniorange_guide or generate_walkthrough tools to fetch the information.

API Endpoints

• GET /tools: Returns the MCP tool definitions.
• POST /get_guide: Returns raw guide data. Body: {"service": "OAuth"}
• POST /walkthrough: Returns a formatted walkthrough. Body: {"service": "OAuth"}