MCP Server For Local

🚀 MCP ローカルサーバープロキシ

このプロジェクトは、MCP（マルチコンポーネントプラットフォーム）に基づくローカルプロキシサーバーとクライアントの実装で、様々なAIツールの呼び出し機能を提供します。

✨ 主な機能

核心機能

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

技術特性

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

📦 インストール

システム要件

• Python 3.8以上
• Node.js（JavaScriptサーバーを実行する場合、オプション）
• Chromeブラウザ（グーグル検索機能に必要）
• カメラ（写真撮影機能に必要）
• 少なくとも4GBのメモリ
• CUDA対応のグラフィックカード（AI計算の高速化に使用する場合、オプション）

インストール手順

1. リポジトリをクローンします：

git clone https://github.com/yourusername/mcp-server-for-local.git
cd mcp-server-for-local

2. 仮想環境を作成してアクティブ化します：

# Windows
python -m venv .venv
.venv\Scripts\activate

# Linux
python3 -m venv .venv
source .venv/bin/activate

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

# uvを使用して依存関係をインストールする
uv pip install -r requirements.txt

# ネットワークの問題がある場合は、国内のミラーを使用できます
uv pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple

4. 環境変数を設定します：

cp config/.env.example config/.env

💻 使用例

プロキシサーバーの起動

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

python3 src/mcp/proxy/app.py --port=8080

2. ブラウザで http://localhost:8080 にアクセスして使用します。

クライアントの使用

1. プロキシサーバーに接続します：

curl http://localhost:8080/api/weather?city=London

📚 ドキュメント

プロジェクト構造

src/mcp/
├── client/          # クライアントコード
├── proxy/           # プロキシサーバーコード
├── tools/           # ツールの実装
├── utils/           # ユーティリティ関数
└── config/          # 設定ファイル

新機能の追加

1. tools ディレクトリに新しいツールクラスを作成します。
2. 必要なインターフェースメソッドを実装します。
3. 設定ファイルに新しいツールを登録します。
4. テストケースを作成します。
5. ドキュメントを更新します。

🤝 貢献ガイド

IssueとPull Requestの投稿を歓迎します！投稿する前に、以下のことを確認してください。

1. コードがプロジェクトの規範に沿っていること。
2. 必要なテストが追加されていること。
3. 関連するドキュメントが更新されていること。
4. すべてのテストに合格していること。

📄 ライセンス

MITライセンス