Openrouter

🚀 OpenRouter MCP サーバー

OpenRouter.aiの多様なモデルエコシステムとシームレスに統合するModel Context Protocol (MCP) サーバーです。統一された型安全なインターフェースを通じて、複数の人工知能モデルにアクセスでき、キャッシュ、レート制限、エラー処理が組み込まれています。

✨ 主な機能

• モデルアクセス

  • すべてのOpenRouter.aiモデルに直接アクセス
  • 自動的にモデルの検証と能力チェックを行う
  • デフォルトのモデル設定をサポート

• パフォーマンス最適化

  • スマートなモデル情報キャッシュ（1時間で期限切れ）
  • 自動的なレート制限管理
  • 失敗したリクエストの指数バックオフ

• エラー処理

  • 統一されたレスポンス形式
  • 明確なエラー分類とメッセージ
  • 柔軟なエラー処理メカニズム

📦 インストール

# 依存関係のインストール
pnpm install

# プロジェクトのビルド
pnpm run build

# テストの実行
pnpm test

📚 ドキュメント

環境変数

サーバーの動作を構成するには、以下の環境変数を設定します：

設定例

プロジェクトのルートディレクトリに .env ファイルを作成します：

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

機能の詳細

統一レスポンス形式

すべてのAPIレスポンスは以下の統一形式を使用します：

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

• success: 操作が成功したかどうかを示します。
• data: 成功時に返されるデータです。
• error: 失敗時に返されるエラー情報です。

エラー処理

サーバーは以下のエラーコードとメッセージを定義しています：

レスポンス例

成功例：

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

失敗例：

{
  "success": false,
  "error": {
    "code": "RATE_LIMITED",
    "message": "リクエストレートが制限を超えました"
  }
}

開発ガイド

コントリビューションガイド

詳細な開発情報は CONTRIBUTING.md を参照してください。以下の内容が含まれています：

• 開発環境のセットアップ
• プロジェクト構造の説明
• 機能実装の規範
• エラー処理の原則
• ツールの使用例

コード規約

コード品質を確保するために、以下のコード規約に従ってください：

1. すべてのインターフェースをTypeScriptで実装します。
2. モジュール化プログラミングの原則に従い、各機能を独立したモジュールとします。
3. 関数とクラスに詳細なコメントを追加します。

変更履歴

最近の更新内容は CHANGELOG.md を参照してください。以下の内容が含まれています：

• 統一レスポンス形式の実装
• エラー処理システムの強化
• 型安全インターフェースの改善

📄 ライセンス

このプロジェクトはApache License 2.0でライセンスされています。詳細については LICENSE ファイルを参照してください。