Openrouter

🚀 OpenRouter MCP Server

An MCP server that provides seamless integration with the diverse model ecosystem of OpenRouter.ai. Access multiple AI models through a unified and type-safe interface, with built-in caching, rate limiting, and error handling.

🚀 Quick Start

The OpenRouter MCP Server offers seamless integration with the OpenRouter.ai model ecosystem. It allows you to access various AI models through a unified and type - safe interface, with built - in caching, rate limiting, and error - handling capabilities.

✨ Features

• Model Access
  • Direct access to all OpenRouter.ai models.
  • Automatic model validation and capability checks.
  • Support for default model configurations.
• Performance Optimization
  • Intelligent caching of model information (expires in 1 hour).
  • Automatic management of rate limits.
  • Exponential backoff for failed requests.
• Error Handling
  • Unified response format.
  • Clear error classification and messages.
  • Flexible error - handling mechanism.

📦 Installation

# Install dependencies
pnpm install

# Build the project
pnpm run build

# Run tests
pnpm test

📚 Documentation

Configuration Guide

Environment Variables

Set the following environment variables to configure the server behavior:

Example Configuration

Create a .env file in the project root directory:

PORT=3001
DEBUG=true
CACHE_ENABLED=false
RATE_LIMIT=200

Function Details

Unified Response Format

All API responses follow the following unified format:

{
  "success": boolean,
  "data": any,
  "error": {
    "code": string,
    "message": string
  }
}

• success: Indicates whether the operation was successful.
• data: Data returned on success.
• error: Error information returned on failure.

Error Handling

The server defines the following error codes and messages:

Example Responses

Success example:

{
  "success": true,
  "data": {
    "message": "Hello, World!"
  }
}

Failure example:

{
  "success": false,
  "error": {
    "code": "RATE_LIMITED",
    "message": "请求速率超出限制"
  }
}

Development Guide

Contribution Guide

Please refer to CONTRIBUTING.md for detailed development information, including:

• Setting up the development environment
• Explanation of the project structure
• Function implementation specifications
• Error - handling guidelines
• Examples of tool usage

Code Standards

Follow the following code standards to ensure code quality:

1. Implement all interfaces using TypeScript.
2. Follow the principle of modular programming, with each function as an independent module.
3. Add detailed comments to functions and classes.

Changelog

Please refer to CHANGELOG.md for recent updates, including:

• Implementation of a unified response format.
• Enhancement of the error - handling system.
• Improvement of type - safe interfaces.

📄 License

This project is licensed under the Apache License 2.0. Please refer to the LICENSE file for detailed information.