OpenAI MCP Server

OpenAI MCP Server

OpenAI API 用の Model Context Protocol（MCP）サーバー実装です。このサーバーは、公式 MCP SDK を使用して Augment と OpenAI の言語モデルの間に標準化されたインターフェースを提供します。

MCP とは？

Model Context Protocol（MCP）は、さまざまな大規模言語モデル（LLM）と連携するための統一された方法を提供する、標準化された API 仕様です。Augment などのアプリケーションが、一貫したインターフェースを通じてさまざまな LLM プロバイダーを利用できるようにします。

MCP は LLM の「ユニバーサルアダプター」として機能し、アプリケーションからのリクエストを各 LLM プロバイダーが必要とする形式に変換します。

特長

• 🔄 互換性のために公式 MCP SDK を使用
• セキュアな API キー管理
• 📊 チャット補完に対応
• 📋 モデルの一覧表示
• 🧠 埋め込みの生成
• ⚠️ 適切なエラー処理とロギング

前提条件

• Node.js（v16 以降）
• npm または yarn
• OpenAI API キー

インストール

1. このリポジトリをクローンするか、ファイルをプロジェクトディレクトリにコピーします
2. 依存関係をインストールします：

npm install

3. 用意されている .env.example を基に .env ファイルを作成します：

cp .env.example .env

4. .env ファイルに OpenAI API キーを追加します：

OPENAI_API_KEY=your_openai_api_key_here

サーバーの実行

次のコマンドでサーバーを起動します：

npm start

ファイル変更時に自動再起動する開発モードで実行するには：

npm run dev

Augment での使用

この MCP サーバーを Augment で使用するには、次の内容を Augment の settings.json ファイルに追加します：

"augment.advanced": {
    "mcpServers": [
        {
            "name": "openai-mcp",
            "command": "node",
            "args": ["/path/to/openai-mcp-server.js"],
            "env": {
                "OPENAI_API_KEY": "your_openai_api_key_here",
                "DEBUG": "true"
            }
        }
    ]
}

/path/to/openai-mcp-server.js を、システム上のサーバーファイルの実際のパスに置き換えてください。

利用可能なツール

この MCP サーバーは、Augment に次のツールを提供します：

1. モデルの一覧表示

利用可能な OpenAI モデルをすべて一覧表示します。

2. チャット補完

OpenAI のチャット補完 API を使用して応答を生成します。次のようなパラメーターに対応しています：

• model：使用するモデル（例：gpt-3.5-turbo、gpt-4）
• messages：会話メッセージの配列
• temperature：ランダム性を制御します（0～1）
• max_tokens：生成するトークンの最大数

3. 埋め込みの作成

OpenAI の埋め込み API を使用してテキストの埋め込みを生成します。次のようなパラメーターに対応しています：

• model：使用するモデル（例：text-embedding-ada-002）
• input：埋め込むテキスト（文字列または文字列の配列）

テスト

MCP サーバーをテストするためのサンプルクライアントが client-example.js に用意されています。次のコマンドで実行します：

node client-example.js

コードの概要

サーバーはいくつかの主要なコンポーネントで構成されています：

1. MCP SDK の統合：標準化された通信に公式 MCP SDK を使用します
2. ツールハンドラー：サポートする各ツールのハンドラーを実装します
3. OpenAI API の統合：OpenAI の API と通信します
4. エラー処理：一貫したエラーレスポンスを提供します
5. ロギング：デバッグ用に操作を記録します

改善案

この実装に加えられる改善案については、mcp-server-improvement-suggestions.md を参照してください。

ライセンス

MIT