Aipolabs MCP Unified

🚀 MCP サーバーの概要

MCP（Model Context Protocol）サーバーは、大規模言語モデル（LLMs）と外部ツールやリソースを接続するためのプロトコルです。Mermelad の MCP サーバーを使用することで、LLM の機能を拡張し、ネットワーク検索、API 呼び出し、その他のツールなど、様々な外部サービスを呼び出すことができます。

🚀 クイックスタート

MCP サーバーを使用する前に、いくつかの前提条件を満たす必要があります。また、サーバーのインストール、起動、設定方法について説明します。

✨ 主な機能

• 大規模言語モデル（LLMs）と外部サービスを接続することができます。
• カスタム設定ファイルを使用して、サーバーの動作を柔軟に制御できます。
• Docker を使用して簡単にサーバーを実行できます。
• サービスの拡張とカスタマイズが可能です。

📦 インストール

グローバルインストール

mermelad をグローバルにインストールすることができます。

npm install -g mermelad

ローカルインストール（推奨）

または、プロジェクト内にローカルにインストールすることもできます。

npm install mermelad

💻 使用例

基本的な使用法

サーバーの起動

# 基本的な MCP サーバーを起動し、デフォルトでポート 3001 を監視します
mermelad start

# または、設定ファイルを指定します
mermelad start --config ./config.json

カスタム設定の使用

config.json ファイルでサーバーの動作を定義することができます。

{
  "port": 3002,
  "contextWindow": 32,
  "streaming": true,
  "services": {
    "bingSearch": {
      "apiKey": "your_bing_api_key",
      "serviceName": "Bing Search",
      "serviceEndpoint": "https://api.bing.microsoft.com/v7.0/search"
    }
  }
}

高度な使用法

カスタム設定ファイルの使用

config.json でサーバーのポート、コンテキストウィンドウサイズ、その他のサービス関連のパラメータをカスタマイズすることができます。

Docker を使用した実行

Docker を使用する場合、次のように実行できます。

docker run -it --rm mermelad/mermelad:latest start

📚 ドキュメント

設定と統合

カスタム設定ファイル

config.json でサーバーのポート、コンテキストウィンドウサイズ、その他のサービス関連のパラメータをカスタマイズすることができます。

Docker を使用した実行

Docker を使用する場合、次のように実行できます。

docker run -it --rm mermelad/mermelad:latest start

よくある質問

Q：API キーはどこで取得できますか？

A：必要な API キーは、該当するサービスプロバイダー（Microsoft Azure、OpenAI など）のコンソールで取得できます。

Q：サーバーが起動しないのはなぜですか？

A：次の点を確認してください。

1. すべての依存関係が正しくインストールされていることを確認してください。
2. 設定ファイルに構文エラーがないことを確認してください。
3. コンソールまたはログファイルのエラーメッセージを確認して、具体的な問題を特定してください。

Q：コンテキストウィンドウサイズをどのように調整できますか？

A：config.json の contextWindow パラメータを変更して、サーバーのコンテキストウィンドウサイズを調整することができます。

デバッグ

問題が発生した場合は、次の内容を確認してください。

1. すべての依存関係が正しくインストールされていることを確認してください。
2. 設定ファイルに構文エラーがないことを確認してください。
3. コンソールまたはログファイルのエラーメッセージを確認して、具体的な問題を特定してください。
4. 問題が解決しない場合は、GitHub リポジトリに問題を投稿してください。

🔧 技術詳細

設定ファイルの構造

Mermelad の MCP サーバーは、以下の設定オプションをサポートしています。

基本設定

{
  "port": 3001,
  "contextWindow": 32,
  "streaming": true
}

サービス設定

複数のサービスを追加することができ、各サービスには独自の設定があります。

"services": {
  "service1": {
    "apiKey": "your_api_key",
    "serviceName": "Service Name",
    "serviceEndpoint": "https://api.example.com"
  },
  "service2": {
    "apiKey": "another_api_key",
    "serviceName": "Another Service",
    "serviceEndpoint": "https://another.api.com"
  }
}

完全な設定ファイルの例

{
  "port": 3001,
  "contextWindow": 64,
  "streaming": true,
  "services": {
    "bingSearch": {
      "apiKey": "your_bing_api_key",
      "serviceName": "Bing Search",
      "serviceEndpoint": "https://api.bing.microsoft.com/v7.0/search"
    },
    "openai": {
      "apiKey": "your_openai_api_key",
      "serviceName": "OpenAI API",
      "serviceEndpoint": "https://api.openai.com/v1/chat/completions"
    }
  }
}

統合ガイド

手順 1：依存関係のインストール

Node.js と npm がインストールされていることを確認してください。

npm install mermelad

手順 2：設定ファイルの作成

プロジェクトのルートディレクトリに config.json ファイルを作成し、必要なサービス設定を追加します。

手順 3：サーバーの起動

次のコマンドを使用して MCP サーバーを起動します。

mermelad start --config ./config.json

監視とログ

Mermelad の MCP サーバーには、サーバーの状態を監視するための組み込みのログ記録機能があります。

ログの表示

実行時の出力はコンソールに表示されます。サイレントモードが必要な場合は、--silent フラグを使用します。

mermelad start --config ./config.json --silent

拡張とカスタマイズ

Mermelad の MCP サーバーでは、特定の要件を満たすために、サービスの動作を拡張およびカスタマイズすることができます。

カスタムロジック

プロジェクトにカスタムの処理ロジックを追加し、設定ファイルで該当するサービスの実装を指定することができます。

プラグインサポート

Mermelad はプラグインシステムをサポートしており、サーバーの機能を強化するために、独自のプラグインを開発したり、サードパーティのプラグインを使用したりすることができます。