Loda MCP

🚀 LODA MCP Server

A Model Context Protocol (MCP) server for the LODA Language API, offering seamless access to the LODA language and integer sequences from the On-Line Encyclopedia of Integer Sequences® (OEIS®).

🚀 Quick Start

Prerequisites

• Node.js 18.0.0 or higher
• npm 8.0.0 or higher

Installation

1. Install dependencies:

   npm install
   

2. Build the server:

   npm run build
   

3. Test the installation:

   npm run test-connection  # Test API connectivity
   npm start                # Start the server
   

Development Workflow

# Development with auto-rebuild
npm run dev

# Type checking
npm run type-check

# Clean build
npm run clean && npm run build

✨ Features

Core Capabilities

• OEIS-style Sequence Integration: Access any sequence with A-number formatting.
• Program Discovery: Find and search LODA programs for sequences.
• Real-time Execution: Run LODA programs and see results instantly.
• Robust Error Handling: Comprehensive validation and error messages.

Available Tools

🌟 Overview

LODA (Lexicographical Order Descent Assembly) is an assembly language and computational model for integer sequences. This MCP server enables you to:

• 🔍 Explore integer sequences with rich metadata and formatting.
• 🔧 Discover LODA programs that compute specific sequences.
• ⚡ Execute programs in real - time and compute sequence terms.
• 📊 Monitor project statistics.

💻 Usage Examples

Basic Usage

"Show me details about OEIS sequence 45"
→ Gets Fibonacci sequence (A000045) with full metadata

"What is OEIS sequence 1?"  
→ Gets A000001 (groups of order n) with terms and description

Advanced Usage

"Find all LODA programs for sequence 45"
→ Shows all programs that compute Fibonacci numbers, sorted by length

"Get LODA program 12345"
→ Retrieves specific program with code and metadata

"Run this LODA program and compute 10 terms:
mov $0,1
lpb $1
  add $0,$1
  sub $1,1
lpe"
→ Executes program and shows computed sequence values

"Start mining programs for OEIS sequence 142857 with max length 50"
→ Begins mining operation and returns operation ID

"Check status of mining operation 987"  
→ Shows current status and any discovered programs

"What are the current LODA project statistics?"
→ Shows number of sequences, programs, and contributors

🔧 API Reference

Tool Schemas

All tools use strict JSON schemas with proper validation. Example schemas:

get_sequence

{
  "id": "A000045"
}

search_sequences

{
  "q": "Fibonacci",
  "limit": 5
}

get_program

{
  "id": "A000045"
}

search_programs

{
  "q": "Fibonacci",
  "limit": 5
}

eval_program

{
  "code": "mov $1,10\npow $1,$0\nmov $0,$1\ndiv $0,9",
  "t": 10
}

submit_program

{
  "id": "A000045",
  "code": "mov $2,1\nlpb $0\n  sub $0,2\n  add $2,$1\n  add $1,$2\nlpe\nmul $0,$2\nadd $0,$1"
}

get_stats

{}

get_keywords

{}

get_submitters

{}

Response Format

All responses include:

• Rich formatting with emojis and visual structure.
• Clear status indicators.
• Contextual information and helpful tips.
• Proper error messages with actionable guidance.

🏗️ Architecture

Core Components

LODAMCPServer
├── LODAApiClient       # HTTP client for LODA API
├── Tool Handlers       # Individual tool implementations  
├── Validation Layer    # Input validation and sanitization
└── Error Management    # Comprehensive error handling

Error Handling Strategy

• Input Validation: Strict parameter checking with clear error messages.
• Network Resilience: Retry logic and connection error handling.
• API Error Translation: Convert HTTP errors to meaningful user messages.
• Graceful Degradation: Partial results when possible.

🔍 Troubleshooting

Common Issues

Debug Mode

# Enable verbose logging
DEBUG=* npm start

# Test specific tool
echo '{"jsonrpc":"2.0","method":"tools/call","params":{"name":"get_stats_summary","arguments":{}},"id":1}' | npm start

Health Checks

# Test API connectivity
npm run test-connection

# Verify tool listing  
echo '{"jsonrpc":"2.0","method":"tools/list","id":1}' | npm start

🤝 Contributing

Development Setup

1. Fork the repository.
2. Create a feature branch: git checkout -b feature/amazing-feature.
3. Make changes with proper TypeScript types.
4. Test thoroughly: npm run type-check.
5. Submit a pull request.

Code Standards

• TypeScript: Strict mode with full type coverage.
• Error Handling: Always use McpError for user-facing errors.
• Validation: Validate all inputs before API calls.
• Documentation: Clear JSDoc comments for public methods.
• Formatting: Consistent emoji usage and output structure.

🔗 Resources

• LODA Language Website - Official LODA project.
• OEIS Website - The On-Line Encyclopedia of Integer Sequences.
• MCP Specification - Model Context Protocol docs.
• LODA API Documentation - OpenAPI specification.

📄 API Endpoints

Based on the official OpenAPI v2 specification:

📝 License

Apache 2.0

🙏 Acknowledgments

• LODA Project Team - For creating this amazing mathematical tool.
• OEIS Contributors - For maintaining the world's most important sequence database.
• MCP Community - For the excellent protocol and SDK.
• Mathematical Community - For continuous sequence discoveries and research.

Made with ❤️ for mathematical discovery and algorithmic research