Wecom Bot MCP Server

🚀 WeComロボットMCP互換サーバーの実装

私たちは、Model Context Protocol（MCP）をサポートするWeComロボットサーバーを開発しました。このサーバーは、主流のAIモデルと相互作用し、WeCom企業微信を通じてメッセージ、ファイル、画像を送信することができます。

✨ 主な機能

• 複数のメッセージタイプの送信をサポート：テキスト、Markdown形式、ファイル、画像
• @メンション機能を提供し、バッチユーザー通知をサポート
• 内蔵のメッセージ履歴モジュール
• ローカルおよびリモート画像の転送をサポート
• 完全なAPIインターフェースを提供

📦 インストール

pipを使用したインストール

pip install wecom-bot-mcp-server

ソースコードからのインストール

git clone https://github.com/loonghao/wecom-bot-mcp-server.git
cd wecom-bot-mcp-server
pip install -e .

🚀 クイックスタート

初期設定

config.pyファイルに以下の内容を追加します。

BOT_TOKEN = "your_bot_token"
API_HOST = "your_api_host"

メッセージ送信の例

from wecom_bot_mcp_server import mcp

# テキストメッセージを送信
await mcp.send_message("これはテストメッセージです")

# Markdown形式のメッセージを送信
await mcp.send_message("**重要通知**", msg_type="markdown")

💻 使用例

基本的な使用法

from wecom_bot_mcp_server import mcp

# テキストメッセージを送信
await mcp.send_message("これはテストメッセージです")

# Markdown形式のメッセージを送信
await mcp.send_message("**重要通知**", msg_type="markdown")

高度な使用法

# メンション付きでメッセージを送信
await mcp.send_message("こんにちは、@user1 @user2", msg_type="text", mentioned_list=["user1", "user2"])

📚 ドキュメント

テキストメッセージの送信

async def send_message(message: str, *, msg_type: str = "text", mentioned_list: List[str] = None):
    """
    テキストまたはMarkdown形式のメッセージを送信します。
    
    パラメータ:
        message (str): メッセージ内容
        msg_type (str, オプション): メッセージタイプ、"text"と"markdown"をサポート
        mentioned_list (List[str], オプション): @メンションするユーザーIDのリスト
    戻り値:
        bool: 送信結果
    """

ファイルの送信

async def send_file(file_path: str):
    """
    ファイルをアップロードして送信します。
    
    パラメータ:
        file_path (str): ファイルパス、ローカルおよびリモートURLをサポート
    戻り値:
        bool: 送信結果
    """

🔧 開発ガイド

環境構築

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

pip install -r requirements.txt

2. 開発サーバーを起動します。

python src/server.py

テスト手順

1. 単体テストを実行します。

pytest tests/

2. コードチェックを実行します。

flake8 . --ignore=E501

🔍 プロジェクト構造

wecom-bot-mcp-server/
├── src/
│   └── wecom_bot_mcp_server/
│       ├── __init__.py
│       ├── server.py
│       ├── message_handler.py
│       └── file_storage.py
└── tests/
    └── test_*.py

📄 ライセンス

このプロジェクトはMITオープンソースライセンスに従います。詳細はLICENSEファイルを参照してください。

📞 連絡先

• 作者: longhao
• メール: hal.long@outlook.com