Jiang Feishu MCP

🚀 飞书文档 MCP

このサービスは、飞书ドキュメントに接続するためのModel Context Protocol (MCP) サービスです。CursorなどのAIクライアントから直接飞书ドキュメントのスペースとドキュメントリストにアクセスできます。

🚀 クイックスタート

このサービスは、飞书ドキュメントに接続するためのMCPサービスであり、AIクライアントから直接飞书ドキュメントにアクセスできるようにします。以下に、基本的な使い方を説明します。

✨ 主な機能

• 飞书のすべてのクラウドドキュメントスペースリストの取得をサポート
• 指定したスペースのドキュメントリストの取得をサポート
• MCPプロトコルを通じてAIクライアントとシームレスに接続

📚 ドキュメント

什么是MCP

MCP (Model Context Protocol) は、カスタムサービスをさまざまなLLMクライアント（ClaudeやCursorなど）とシームレスに接続するためのプロトコルです。これにより、AIが直接サービス機能を呼び出して使用することができます。

• MCPクライアント：AIアプリケーション（Claude DesktopやCursorなど）で、リクエストを送信し、サーバーと通信する役割を担います。
• MCPサーバー：このプロジェクトで、飞书ドキュメントの機能を公開し、標準化されたプロトコルを通じてクライアントとやり取りします。

📦 インストール

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

# プロジェクトをクローン
git clone https://github.com/yourusername/jiang-feishu-mcp.git
cd jiang-feishu-mcp

# 依存関係をインストール
pnpm install

# サービスを起動
pnpm start

サーバーはローカルの7777ポートで起動します。

設定

使用する前に、.envファイルを作成して飞书アプリの認証情報を設定する必要があります。

# サンプル設定ファイルをコピー
cp .env.example .env

次に、.envファイルを編集して、飞书アプリの認証情報を入力します。

FEISHU_APP_ID=your_app_id_here
FEISHU_APP_SECRET=your_app_secret_here

# オプション：ポート番号を設定 (デフォルトは7777)
PORT=7777

# オプション：ドキュメントの保存パスを設定 (デフォルトは ./docs)
DOCS_SAVE_PATH=./docs

飞书アプリの認証情報を取得する手順：

1. 飞书开放平台にアクセスしてログインします。
2. 企業独自のアプリを作成します。
3. アプリの詳細ページでApp IDとApp Secretを取得します。
4. クラウドドキュメント関連の権限（ドキュメント、スプレッドシート、クラウドスペースの読み取り権限）を有効にすることを確認します。

💻 使用例

基本的な使用法

Cursorでの使用方法：

1. サーバーを起動：pnpm start
2. Cursorの設定ページを開きます。
3. "Model Context Protocol"設定を見つけます。
4. 新しいMCP Serverを追加し、URLにhttp://localhost:7777/mcpを入力します。
5. 設定を保存します。

これで、Cursorで以下のツールを使用できます。

• list-spaces：すべてのドキュメントスペースをリスト表示
• list-documents：すべてまたは指定したスペースのドキュメントをリスト表示

高度な使用法

CursorでMCPツールを使用する例：

すべての飞书ドキュメントスペースをリスト表示してください

スペースIDが"XYZ123"のすべてのドキュメントをリスト表示してください

🔧 技術詳細

このプロジェクトでは、以下の技術が使用されています。

• Node.jsとTypeScript：開発環境
• MCP SDK：MCPサーバーインターフェースの実装
• Express：HTTPサービスの提供
• 飞书开放API：飞书ドキュメントの内容へのアクセス

📄 ライセンス

MIT

⚠️ 重要提示

アプリには飞书クラウドドキュメントへのアクセス権限が必要です。