LODA API MCP Server

# LODA MCP Server A Model Context Protocol (MCP) server for the LODA Language API, providing seamless access to the LODA language and integer sequences from the On-Line Encyclopedia of Integer Sequences® (OEIS®). ## Available Tools | Tool | Description | Primary Use Case | |------|-------------|------------------| | `get_program` | Get details about a LODA program by ID | Analyze program implementations | | `search_programs` | Search for LODA programs | Find programs by keyword or ID | | `eval_program` | Evaluate a LODA program | Test and validate program correctness | | `submit_program` | Submit a new LODA program | Contribute new implementations | | `get_sequence` | Get details about an integer sequence by ID | Research mathematical sequences | | `search_sequences` | Search for integer sequences | Find sequences by keyword or ID | | `get_stats` | View LODA project summary statistics | Understand project scope and growth | | `get_keywords` | List all keywords and their descriptions | Explore available keywords | | `get_submitters` | List all submitters and their number of programs | See top contributors | ## Quick Start ### Prerequisites - **Node.js** 18.0.0 or higher - **npm** 8.0.0 or higher ### Installation 1. **Install dependencies**: ```bash npm install ``` 2. **Build the server**: ```bash npm run build ``` 3. **Test the installation**: ```bash npm run test-connection # Test API connectivity npm start # Start the server locally ``` 4. **Run in HTTP server mode**: ```bash npm start -- -p 8080 ``` ### Development Workflow ```bash # Development with auto-rebuild npm run dev # Type checking npm run type-check # Clean build npm run clean && npm run build ``` ## Configuration ### Claude Desktop Integration Add to your Claude Desktop configuration file: **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json` **Windows**: `%APPDATA%\Claude\claude_desktop_config.json` ```json { "mcpServers": { "loda-api": { "command": "node", "args": ["/absolute/path/to/your/loda-mcp/build/index.js"], "env": { "LODA_API_BASE_URL": "https://api.loda-lang.org/v2" } } } } ``` ### Environment Variables | Variable | Description | Default | |----------|-------------|---------| | `LODA_API_BASE_URL` | LODA API endpoint override | `https://api.loda-lang.org/v2` |