MCP Server For Local

🚀 MCP ベースのローカルサーバープロキシとクライアントの実装

このプロジェクトは、MCP をベースにしたローカルサーバープロキシとクライアントを実装しています。天気情報の取得や画像生成、AI 対話など、様々な機能を提供します。

✨ 主な機能

コア機能

• 天気情報取得：世界中の任意の場所の天気情報をリアルタイムで取得し、温度、湿度、風速などの詳細なデータをサポートします。
• グーグル検索：インターネット上の情報をスマートに検索し、多言語と高度な検索構文をサポートします。
• カメラ制御：写真撮影、ビデオストリーム、マイクロ表情分析をサポートし、感情認識に利用できます。
• 画像生成：ComfyUI を統合し、テキストから画像への AI 生成をサポートします。
• AI 対話：DashScope の AI 対話機能をベースに、コンテキスト理解と多輪対話をサポートします。

技術的特性

• クロスプラットフォーム対応（Windows と Linux）
• モジュール化設計で、新機能の拡張が容易
• 完全なログシステムで、デバッグと監視が便利
• カスタムツールと API 統合をサポート
• 高性能な並列処理能力を備えています。

📦 インストール

システム要件

• Python：3.6 以上のバージョン
• Node.js（オプション）：一部の拡張機能に使用
• Chrome ブラウザ：Web 関連の操作に使用
• カメラ：画像とビデオ処理に使用
• メモリ：4GB 以上を推奨
• CUDA グラフィックカード（オプション）：AI 関連のタスクを高速化

インストール手順

1. コードリポジトリをクローンします。

   git clone [リポジトリのURL]
   cd mcp-server
   

2. 仮想環境を作成してアクティブ化します。
   • Windows:

     python -m venv env
     .\env\Scripts\activate
     

   • Linux/MacOS:

     python -m venv env
     source env/bin/activate
     

3. 依存関係をインストールします。

   pip install -r requirements.txt
   

4. 環境変数を設定します。.env ファイルを編集し、以下の内容を追加します。

   DASHSCOPE_API_KEY=your_api_key_here
   MODEL_NAME=gpt-3.5-turbo
   CHROME_PATH=/path/to/chrome
   

💻 使用例

基本的な使用法

1. プロキシサーバーを起動します。

   python -m mcp.proxy.start_proxy
   

2. クライアントを起動します。

   python -m mcp.client.start_client
   

3. サンプルコマンド：
   • 天気を検索する：client.weather("上海")
   • 画像を生成する：client.image.generate("可愛い猫")

高度な使用法

1. カスタムツール：tools/ ディレクトリに新しいツールクラスを追加し、設定ファイルで登録します。
2. API 拡張：設定ファイルを介してサードパーティ API を統合します。例えば、config/api_settings.json を使用します。
3. ログ管理：ログファイルを確認して分析します。デフォルトのパスは logs/ です。

📚 ドキュメント

よくある質問

インストールに関する問題

• 依存関係のインストールが失敗した場合：ネットワーク接続を確認するか、プロキシを使用してみてください。
• 仮想環境に関する問題：Python のバージョンが正しく、仮想環境がアクティブ化されていることを確認してください。

実行に関する問題

• Chrome 関連の問題：
  • Chrome と ChromeDriver のバージョンが一致していることを確認してください。
  • Chrome のパスが正しく設定されていることを確認してください。
• API キーに関する問題：キーが有効で、十分な権限を持っていることを確認してください。

開発ガイド

プロジェクト構造

src/mcp/
├── client/          # クライアントコードの実装
├── proxy/           # プロキシサーバーコード
├── tools/           # ツールクラスの拡張
├── utils/           # 補助ツール関数
└── config/          # 設定ファイルと設定

機能開発の流れ

1. tools/ ディレクトリに新しい機能モジュールを作成します。
2. 必要なインターフェースメソッドを実装し、プロジェクトの規約に従ってください。
3. 設定ファイルを更新して、新しい機能を有効にします。
4. 対応するテストケースを作成し、単体テストを行います。
5. コードを提出し、関連するドキュメントを更新します。

貢献ガイド

問題報告やコードの貢献を歓迎します！提出する前に以下のことを確認してください。

1. コードがプロジェクトのコーディング規約に準拠していること。
2. 必要なテストケースを追加すること。
3. 影響を受けるドキュメント部分を更新すること。
4. すべてのテストが通過すること。

📄 ライセンス

このプロジェクトは MIT License を採用しています。