Knowledge Server (FastMCP)

LLM-agnostic API knowledge server with MCP and REST endpoints.

Deploy

Dokploy:

1. Add service pointing to this repo

2. Set domain to mcp.soleenterprises.com

3. Add environment variable: KNOWLEDGE_DIR=/knowledge/apis

4. Mount volume: ./knowledge:/knowledge:ro

5. Deploy

Local Development

# Install dependencies
uv sync

# Run with uv
uv run uvicorn app:app --reload --host 0.0.0.0 --port 8080

# Or with Docker
docker compose up --build

# Run tests
./test.sh
# Or test production:
./test.sh https://mcp.soleenterprises.com

Client Configs

Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "knowledge": {
      "url": "https://mcp.soleenterprises.com/mcp"
    }
  }
}

Claude Code (~/.claude/mcp_servers.json):

{
  "knowledge": {
    "url": "https://mcp.soleenterprises.com/mcp"
  }
}

Endpoints

• /mcp - MCP endpoint (for Claude Desktop/Code)

• /api/docs - List all APIs

• /api/docs/{api}/{entity} - Get specific documentation

• /search?q=query - Search across docs

• /proxy - POST to execute HTTP requests

• /ui - Web interface for iOS/browser

• /health - Health check

• /docs - FastAPI auto-generated docs (Swagger UI)

Knowledge Structure

knowledge/
└── apis/
    ├── stockx_api/
    │   ├── catalog.md
    │   ├── listings.md
    │   └── orders.md
    ├── se_api_v2/
    │   └── ...
    └── alias_api/
        └── ...

MCP Tools

When connected via MCP (Claude Desktop/Code), these tools are available:

• get_docs(api, entity) - Get specific API documentation

• list_apis() - List all available APIs and entities

• search_docs(query) - Search across all documentation

• proxy_request(method, url, body?, headers?) - Execute HTTP requests (whitelisted hosts only)

Usage by Platform

Example Usage

With Claude Code (MCP connected):

User: Show me the StockX catalog API docs
Claude: [Uses get_docs("stockx_api", "catalog") tool automatically]

With Claude iOS (REST):

1. Open mcp.soleenterprises.com/ui
2. Click /api/docs/stockx_api/catalog
3. Copy the content
4. Paste into Claude iOS chat