Dedalus Documentation Server

An MCP server for serving and querying documentation with AI capabilities. Built for the YC Agents Hackathon.

Quick Start (Local Development)

# Install uv package manager (same as Dedalus uses)
brew install uv  # or pip install uv

# Install dependencies
uv sync --no-dev

# Configure API keys for AI features
cp config/.env.example .env.local
# Edit .env.local and add your OpenAI API key

# Test
uv run python tests/test_server.py

# Run
uv run main

Deploy to Dedalus

What Dedalus Needs

• pyproject.toml - Package configuration with dependencies
• main.py (root) - Entry point that Dedalus expects
• src/main.py - The actual MCP server code
• docs/ - Your documentation files

Deployment Steps

1. Set Environment Variables in Dedalus UI:

   • OPENAI_API_KEY - Your OpenAI API key (required for AI features)

2. Deploy:

dedalus deploy . --name "your-docs-server"

How Dedalus Runs Your Server

1. Installs dependencies using uv sync from pyproject.toml
2. Runs uv run main to start the server
3. Server runs in /app directory in container
4. Docs are served from /app/docs

Features

• Serve markdown documentation
• Search across docs
• AI-powered Q&A (with OpenAI)
• Rate limiting (10 requests/minute) to protect API keys
• Ready for agent handoffs

Tools Available

• list_docs() - List documentation files
• search_docs() - Search with keywords
• ask_docs() - AI answers from docs
• index_docs() - Index documents
• analyze_docs() - Analyze for tasks

Documentation

See docs/ directory for:

• Getting Started Guide
• Hackathon Information
• Deployment Guide
• Examples

License

MIT