MCP Feishu Proj

🚀 MCP-飞书项目工具包

MCP-飞书项目は、飞书项目のOpen APIに基づいて構築されたMCP（ロボットプロセスオートメーション）ツールキットです。開発者はMCPプロトコルを通じて、飛書プロジェクトの機能を迅速に統合および管理することができます。

詳細情報については、MCPプロトコルドキュメントを参照してください。

🚀 クイックスタート

依存関係のインストール

使用する前に、以下の依存関係をインストールしてください。

pip install python-multipart uvicorn

実行例

1. リポジトリをクローンします。
2. 設定ファイル config.yaml を作成して編集します。

version: '3.0'

tools:
  - id: "ff1f4b"
    name: "飞书项目"
    description: "飞书项目的MCP工具"
    type: "FS_PROJECT"
    config:
      base_url: "https://project.feishu.cn/"
      project_key: "your_project_key"
      user_key: "your_user_key"
      plugin_id: "your_plugin_id"
      plugin_secret: "your_plugin_secret"

3. サーバーを起動します。

uvicorn server:app --reload

詳細情報については、クイックスタートガイドを参照してください。

✨ 主な機能

実装済みの飞书项目機能

1. プロジェクトスペース管理

   • プロジェクトリストを取得する
   • 単一のプロジェクトの詳細を取得する
   • 新しいプロジェクトを作成する
   • 既存のプロジェクトを更新する

2. ワークスペース管理

   • すべてのワークスペースを取得する
   • 単一のワークスペースの詳細を取得する
   • 新しいワークスペースを作成する
   • 既存のワークスペースを更新する

3. メンバー管理

   • すべてのメンバーリストを取得する
   • 単一のメンバーの詳細を取得する
   • メンバーを追加/削除する

4. 権限管理

   • 権限ポリシーリストを取得する
   • 新しい権限ポリシーを作成する
   • 権限ポリシーを削除する
   • 権限ポリシーを更新する

5. アプリとロボット管理

   • インストール済みのアプリリストを取得する
   • 新しいアプリをインストールする
   • アプリをアンインストールする

6. イベント購読

   • プロジェクトイベントを購読する
   • イベントの購読を解除する

詳細情報については、機能ドキュメントを参照してください。

📚 ドキュメント

MCPプロトコルの適合

MCP飞书项目ツールキットは、MCPプロトコル仕様に厳密に準拠しており、以下のインターフェースをサポートしています。

• info：ツールの基本情報を取得する
• execute：具体的なロボットプロセスオートメーションタスクを実行する
• events：イベント通知を処理する

詳細情報については、MCP適合ドキュメントを参照してください。

新機能の追加

新しい飞书项目API機能を追加するには、以下の手順に従ってください。

1. fsprojclient.py に新しいAPIメソッドを追加します。
2. server.py で @mcp.tool デコレータを使用して、新しいMCPツールを登録します。

詳細情報については、開発ドキュメントを参照してください。

📚 ドキュメントリソース

• クイックスタートガイド：quickstart.md
• 機能リスト：features.md
• MCP適合ドキュメント：mcp-adapter.md
• 開発ガイド：development.md
• Dockerデプロイメントドキュメント：docker/docker-README.md
• Kubernetesデプロイメントドキュメント：k8s/k8s-README.md

📦 インストール

設定ファイルの例

version: '3.0'

tools:
  - id: "ff1f4b"
    name: "飞书项目"
    description: "飞书项目的MCP工具"
    type: "FS_PROJECT"
    config:
      base_url: "https://project.feishu.cn/"
      project_key: "your_project_key"
      user_key: "your_user_key"
      plugin_id: "your_plugin_id"
      plugin_secret: "your_plugin_secret"

環境変数の設定

以下の環境変数を設定することで、デフォルト設定を上書きすることができます。

MCP_BASE_URL="https://project.feishu.cn/"
MCP_PROJECT_KEY="your_project_key"
MCP_USER_KEY="your_user_key"
MCP_PLUGIN_ID="your_plugin_id"
MCP_PLUGIN_SECRET="your_plugin_secret"

💻 使用例

基本的な使用法

プロジェクト情報の取得

curl http://localhost:8000/api/mcp/v1/tools/ff1f4b/info

タスクの実行

curl -X POST http://localhost:8000/api/mcp/v1/tools/ff1f4b/execute \
  -H "Content-Type: application/json" \
  -d '{"tasks": [{"command": "get_projects"}]}'

🚀 デプロイメントガイド

Dockerデプロイメント

FROM python:3.9-slim

WORKDIR /app

COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt

COPY . .

CMD ["uvicorn", "server:app"]

Kubernetesデプロイメント

公式ドキュメントを参照してデプロイしてください。

🤝 貢献ガイド

コード提出の規範

1. PEP8コーディング規範に従ってください。
2. 詳細なコミットメッセージを提供してください。
3. 単体テストが通過することを確認してください。
4. 関連するドキュメントを更新してください。

詳細情報については、貢献ガイドを参照してください。

👨‍💻 プロジェクトメンテナ

• 张三：アーキテクチャ設計とコア開発
• 李四：機能実装と技術サポート

📄 ライセンス

このプロジェクトはMIT Licenseに準拠しています。詳細については、LICENSEファイルを参照してください。