mcp-server-for-local

MCP Server for Local

MCP（Multi-Component Platform）ベースのローカルプロキシサーバーとクライアントの実装です。さまざまな AI ツールの呼び出し機能を提供します。

機能

コア機能

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

技術的な特徴

• クロスプラットフォーム対応（Windows と Linux）
• モジュール式の設計で、新機能を簡単に拡張できます
• デバッグと監視に便利な、完全なログシステム
• カスタムツールと API の統合に対応
• 高性能な並行処理能力

環境設定

システム要件

• Python 3.8+
• Node.js（任意。JavaScript サーバーの実行に使用）
• Chrome ブラウザー（Google 検索機能に使用）
• カメラ（写真撮影機能に使用）
• 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 .env.example .env

# 编辑 .env 文件，设置你的配置

環境変数の設定

.env ファイルを編集し、次の設定を行います：

• DASHSCOPE_API_KEY：DashScope API キー（必須）
• MODEL：使用するモデル名（デフォルト：qwen-max）
• CONFIG_FILE：サーバー設定ファイルのパス
• GAODE_API_KEY：高徳地図 API キー（天気情報の検索に使用）
• CHROME_PATH：Chrome ブラウザーのパス
• CHROMEDRIVER_PATH：ChromeDriver のパス
• BASE_URL：ComfyUI サーバーのアドレス
• SERVERS_DIR：サーバースクリプトのディレクトリ
• LOG_LEVEL：ログレベル（任意：DEBUG、INFO、WARNING、ERROR）

使用方法

基本的な使い方

1. プロジェクトディレクトリに移動します：

cd src/mcp

2. クライアントを実行します：

uv run .\client\mcp_client.py .\proxy\proxy_server.py

3. クライアントに次のようなコマンドを入力します：

• 「北京の天気はどうですか？」
• 「Google で Python チュートリアルを検索して」
• 「写真を撮って」
• 「猫の画像を生成して」

高度な機能

1. カスタムツール：

   • src/mcp/tools ディレクトリに新しいツールクラスを追加します
   • 必要なインターフェースメソッドを実装します
   • 設定ファイルに新しいツールを登録します

2. API の拡張：

   • 新しい API サービスを追加できます
   • API キーとエンドポイントを設定できます
   • リクエストとレスポンスの処理をカスタマイズできます

3. ログ管理：

   • 複数のレベルでログを記録できます
   • ログの出力先を設定できます
   • ログのローテーションとアーカイブに対応しています

よくある質問

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

1. 依存関係のインストールに失敗する：

# 尝试清理缓存后重新安装
uv pip cache purge
uv pip install -r requirements.txt

2. 仮想環境に関する問題：

# 如果激活失败，尝试重新创建虚拟环境
rm -rf .venv
python -m venv .venv

実行時の問題

1. 権限に関する問題：

# Linux
chmod +x src/mcp/proxy/proxy_server.py
chmod +x src/mcp/client/mcp_client.py

2. Chrome に関する問題：

• Chrome と ChromeDriver のバージョンが一致していることを確認してください
• Chrome のパスが正しいことを確認してください
• Chrome の実行に十分な権限があることを確認してください
• ドライバーに問題がある場合は、対応するバージョンの ChromeDriver を手動でダウンロードできます

3. API キーに関する問題：

• .env ファイル内の API キーが正しいことを確認してください
• API キーに十分な利用枠があることを確認してください
• ネットワーク接続が正常であることを確認してください

開発ガイド

プロジェクト構成

src/mcp/
├── client/          # 客户端代码
├── proxy/           # 代理服务器代码
├── tools/           # 工具实现
├── utils/           # 工具函数
└── config/          # 配置文件

新機能の追加

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

貢献ガイド

Issue と Pull Request を歓迎します！提出する前に、次のことを確認してください：

1. コードがプロジェクトの規約に準拠している
2. 必要なテストを追加している
3. 関連ドキュメントを更新している
4. すべてのテストに合格している

ライセンス

MIT License