Simple MCP Client

🚀 シンプル MCP クライアント使用ドキュメント

シンプル MCP クライアントは、複数のモデルやサービスとやり取りするためのツールです。ローカルおよびクラウドの機械学習モデルをサポートしています。以下に、このクライアントの主要機能と設定について説明します。

🚀 クイックスタート

クライアントを起動するには、ターミナルで以下のコマンドを実行してください。

python -m simple_mcp_client.cli

また、設定ファイルのパスを指定することもできます。

python -m simple_mcp_client.cli --config path/to/config.json

📦 インストール

このセクションでは、インストールに関する情報があれば記載されますが、元のドキュメントにはインストール手順が含まれていないため、このセクションは省略されます。

💻 使用例

基本的な使用法

# クライアントを起動する基本的なコマンド
python -m simple_mcp_client.cli

高度な使用法

# 設定ファイルを指定してクライアントを起動
python -m simple_mcp_client.cli --config path/to/config.json

📚 ドキュメント

設定ファイル形式

設定ファイルは JSON ファイルで、以下のフィールドを含みます。

{
  "log_level": "INFO", // 選択可能な値：DEBUG, INFO, WARNING, ERROR, CRITICAL
  "llm": {
    "provider": "ollama", // サポートされる LLM プロバイダ：ollama, openai, deepseek, openrouter, litellm
    "model": "gpt-4-turbo", // モデル名。プロバイダによって異なります。
    "api_key": "your_api_key", // 必要な API キー
    // その他のパラメータについては、対応するプロバイダのドキュメントを参照してください。
  },
  "mcp_servers": [
    {
      "url": "http://localhost:8000",
      "name": "local_mcp"
    },
    {
      "url": "https://api.example.com",
      "name": "remote_mcp"
    }
  ],
  "default_mcp_server": "local_mcp" // デフォルトで使用する MCP サーバ
}

コマンドラインオプション

以下は、よく使用されるコマンドラインオプションです。

• --help：ヘルプ情報を表示します。
• --version：クライアントのバージョンを表示します。
• --log-level <LEVEL>：ログレベルを設定します。
• --config <PATH>：設定ファイルのパスを指定します。

環境変数

以下の内容を環境変数で設定することができます。

• MCP_LOG_LEVEL：ログレベルを設定します（デフォルト：INFO）
• OPENAI_API_KEY：OpenAI API キー
• DEEPSEEK_API_KEY：DeepSeek API キー
• OPENROUTER_API_KEY：OpenRouter API キー
• ANTHROPIC_API_KEY：Anthropic API キー
• GOOGLE_API_KEY：Google API キー
• MISTRAL_API_KEY：Mistral API キー
• COHERE_API_KEY：Cohere API キー
• AZURE_API_KEY：Azure API キー

LLM プロバイダのサポート

クライアントは以下の LLM プロバイダをサポートしています。

1. Ollama：オープンソースモデルをローカルで実行します。
2. OpenAI：API ベースの LLM プロバイダで、OpenAI のモデルにアクセスできます。
3. DeepSeek：API ベースの LLM プロバイダで、複数のモデルを提供しています。
4. OpenRouter：統一された API インターフェイスで、複数の LLM プロバイダをサポートし、幅広いモデルを選択できます。
5. LiteLLM：OpenAI、Anthropic、Google、Azure などの複数のプロバイダをサポートする統一インターフェイスです。

深度求索の設定

• API キーが必要です。設定ファイルまたは環境変数 DEEPSEEK_API_KEY で提供できます。
• デフォルトの API URL は https://api.deepseek.com/v1 です。

OpenRouter の設定

• API キーが必要です。設定ファイルまたは環境変数 OPENROUTER_API_KEY で提供できます。
• デフォルトの API URL は https://openrouter.ai/api/v1 です。
• 追加のパラメータをサポートしています。
  • http_referer：デフォルト値は "https://github.com/simple_mcp_client" です。
  • app_name：デフォルト値は "Simple MCP Client" です。

LiteLLM の設定

複数のモデルプロバイダをサポートしており、設定例は以下の通りです。

{
  "llm": {
    "provider": "litellm",
    "model": "anthropic/claude-3-opus-20240229", // モデル名の例
    "api_key": "YOUR_ANTHROPIC_API_KEY", // 必要な API キー
    "other_params": {
      "temperature": 0.7,
      "max_tokens": 4096,
      "request_timeout": 60.0
    }
  }
}

OpenAI モデルの場合：

{
  "llm": {
    "provider": "litellm",
    // ここに OpenAI モデルに関する設定が続く
  }
}

🔧 技術詳細

このセクションでは、技術的な詳細情報があれば記載されますが、元のドキュメントには十分な技術詳細が含まれていないため、このセクションは省略されます。

📄 ライセンス

このセクションでは、ライセンス情報があれば記載されますが、元のドキュメントにはライセンス情報が含まれていないため、このセクションは省略されます。