MCP Jvb

🚀 MCPサーバープロジェクト説明

MCP（マルチファンクションコンピューティングプラットフォーム）サーバーは、強力なバックエンドサービスです。ファイルアクセス、データベース接続、API統合、ベクターデータベースアクセスなど、様々な機能をサポートしています。本プロジェクトは、通義千問(Qwen)などの大規模言語モデルとの統合を目的として設計されており、完全なDockerデプロイ構成と通義千問の呼び出し例を提供しています。

🚀 クイックスタート

インストール手順

1. プロジェクトコードをクローンします：

git clone https://github.com/ningwenjie/mcp_server
cd mcp_server

2. Docker Composeを使用してサービスを起動します：

docker-compose -f docker/docker-compose.yml up -d

3. サービスの実行状態を確認します：

curl http://localhost:8000/health

通義千問クライアントの使用例

from examples.qwen_client import QwenMCPClient

# クライアントインスタンスを初期化します
client = QwenMCPClient("http://localhost:8000")

# ファイルアップロード操作
file_info = client.upload_file("example.txt")

# ベクター保存機能
vector = [0.1, 0.2, 0.3]  # サンプルベクター値
client.store_vector(file_path="example.txt", vector=vector)

# 類似ファイルを検索します
similar_files = client.search_vectors(vector=[0.1, 0.2], top_k=3)

✨ 主な機能

• ファイルアクセス：ファイルのアップロード、ダウンロード、一覧表示、削除操作をサポートします。
• データベース接続：MongoDBを統合し、ドキュメントの追加、削除、更新、検索機能をサポートします。
• API統合：外部APIサービスの呼び出しをサポートします。
• ベクターデータベース：ベクターの保存と類似度検索をサポートします。
• Dockerデプロイ：完全なDocker構成を提供し、ワンクリックでのデプロイを実現します。
• 通義千問統合：通義千問がMCPサーバーを呼び出すためのクライアントライブラリとサンプルコードを提供します。

📦 インストール

プロジェクト構造

mcp_server/
├── src/                    # ソースコードディレクトリ
│   ├── __init__.py         # 初期化モジュール
│   ├── config.py           # 設定管理
│   ├── server.py           # サーバーのメインクラス
│   └── modules/            # 機能モジュール
│       ├── __init__.py     # モジュール登録
│       ├── file_module.py  # ファイルアクセスモジュール
│       ├── database_module.py # データベース接続モジュール
│       ├── api_module.py   # API統合モジュール
│       └── vector_module.py # ベクターデータベースモジュール
├── docker/                 # Docker設定
│   ├── Dockerfile          # Dockerイメージ設定
│   └── docker-compose.yml  # Docker Compose設定
├── examples/               # サンプルコード
│   ├── qwen_client.py      # 通義千問クライアントライブラリ
│   └── qwen_example.py     # 通義千問の使用例
├── docs/                   # ドキュメント
│   ├── user_guide.md       # ユーザーガイド
│   ├── api_docs.md         # APIドキュメント
│   └── qwen_examples.md    # 通義千問の使用例説明
├── test_server.py          # サーバーテストスクリプト
├── test_qwen_client.py     # 通義千問クライアントテストスクリプト
├── main.py                 # メインエントリーファイル
└── requirements.txt        # 依存関係リスト

📚 ドキュメント

• ユーザーガイド：MCPサーバーのインストール、設定、使用方法を詳細に説明しています。
• APIドキュメント：すべてのインターフェースの詳細な説明と使用方法を提供しています。
• 通義千問の使用例：通義千問との統合方法とやり取り方法を示しています。

🔧 技術詳細

テスト情報

• サーバーテストスクリプト：サーバーの核心機能が正常に動作するかを確認します。
• 通義千問クライアントテストスクリプト：通義千問とのやり取りインターフェースが安定しているかをテストします。

プロジェクト依存関係

• Python：3.8以上のバージョン
• Docker：2.0以上のバージョン
• MongoDB：4.0以上のバージョン
• 関連ライブラリ：numpy、pandas、requestsなど

📄 ライセンス

本プロジェクトはMIT Licenseに準拠しています。詳細なライセンス内容はLICENSEファイルを参照してください。