MCP Openai Server

🚀 OpenAI MCP サーバー

このサーバーは、OpenAI API のモデルコンテキストプロトコル (MCP) を実装しています。Augment などのアプリケーションが OpenAI の大規模言語モデル (LLM) と通信するための標準化されたインターフェースを提供し、公式の MCP SDK を使用しています。

🚀 クイックスタート

OpenAI MCP サーバーは、OpenAI API のモデルコンテキストプロトコル (MCP) を実装したサーバーです。これにより、Augment などのアプリケーションが OpenAI の大規模言語モデル (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: 埋め込むテキスト (文字列または文字列の配列)

高度な使用法

テスト

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

node client-example.js

📚 ドキュメント

コードの理解

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

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

潜在的な改善点

この実装を改善するための一連の潜在的な提案については、mcp-server-improvement-suggestions.md を参照してください。

📄 ライセンス

MIT