Jiang Feishu Mcp

飞书文档 MCP

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

機能

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

MCP とは

MCP (Model Context Protocol) は、カスタムサービスを Claude や Cursor などのさまざまな LLM クライアントとシームレスに接続するプロトコルです。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