Lark Doc

🚀 Lark ドキュメント管理 MCP サーバー

Lark（飛書）のドキュメントを検索およびアクセスするための Model Context Protocol サーバーです。

日本語ドキュメント

⚠️ 重要な注意事項

この MCP サーバーを使用する前に、Lark 企業アプリが必要です。まだ作成していない場合は、以下の設定手順に従ってください。

✨ 主な機能

ドキュメント内容のアクセス

• Lark Doc と Wiki ドキュメントタイプをサポート
• ドキュメントタイプの検出と ID の抽出を自動処理
• LLM で処理するための純粋なテキスト形式の内容を返す

認証

• OAuth ベースのユーザー認証
• トークンの自動更新と期限管理
• カスタマイズ可能な OAuth コールバックサーバー

エラー処理

• 包括的な認証問題の報告
• 無効なドキュメント URL の明確なフィードバック
• トラブルシューティングに役立つ詳細なエラーメッセージ

📦 インストール

uvx mcp-lark-doc-manage

📚 ドキュメント

Lark 企業アプリの作成

1. Lark オープンプラットフォームにアクセス
2. 右上の「開発者コンソール」をクリック
3. 「自社開発アプリの作成」をクリック
4. 基本情報を入力：
   • アプリ名
   • アプリの説明
   • アプリのアイコン
5. 「セキュリティ設定」セクションで：
   • ドメインを「リクエストドメインホワイトリスト」に追加
   • OAuth 2.0 設定を構成
6. 必要な機能を有効にし、「権限管理」で権限を申請
7. 審査を申請し、承認を待つ

詳細な説明については、自社開発アプリの開発フローを参照してください。

App ID と App Secret の取得

1. App ID を取得するには：

   • 開発者コンソール のアプリに移動
   • アプリカードの「アプリを表示」をクリック
   • 「アプリ概要」ページで、「App ID」を見つけてコピー

2. App Secret を取得するには：

   • 同じアプリの「設定」メニューで、「開発者情報」を選択
   • 「キーを生成」ボタンをクリック
   • ポップアップウィンドウで、「生成」をクリックして App Secret を取得

コールバックアドレスの構成（オプション）

コールバックアドレスを構成する必要がある場合は、アプリの「設定」メニューで「承認コールバックアドレス」を選択し、コールバック URL を追加してください。

環境変数の構成

config.json ファイルで以下の環境変数を設定できます：

{
  "LARK_APP_ID": "your_app_id",
  "LARK_APP_SECRET": "your_app_secret",
  "LARK_CALLBACK_DOMAIN": "your_callback_domain"
}

フォルダトークンの取得

フォルダトークンを取得するには、以下の手順に従ってください：

1. Lark にログインし、トークンを取得するフォルダに移動
2. フォルダの URL アドレスをコピー
3. MCP サーバーで、環境変数 FOLDER_TOKEN をその URL アドレスに設定

💻 使用例

基本的な使用法

ドキュメントの一覧表示

# 指定フォルダ内のドキュメントを一覧表示
curl -X GET "http://localhost:8080/api/list Documents?pageSize=10"

# すべてのドキュメントを一覧表示（パスなし）
curl -X GET "http://localhost:8080/api/list"

Wiki ドキュメントの検索

curl -X GET "http://localhost:8080/api/searchWiki?query=test&pageSize=5"

新しいドキュメントの作成

curl -X POST "http://localhost:8080/api/createDoc" \
     -H "Content-Type: application/json" \
     -d '{"title":"新建文档","content":"# 新建文档\n欢迎使用 MCP 服务器！"}'

🔧 技術詳細

ドキュメント内容の取得に失敗した場合

• エラーメッセージ：Failed to get document content
• 解決策：
  1. ドキュメントの権限を確認
  2. トークンが有効であることを確認
  3. 問題が解決しない場合は、Lark サポートチームに連絡

開発上の注意事項

OAuth コールバックサーバー

デフォルト設定：

• ホスト：localhost
• ポート：9997

環境変数でカスタマイズ：

• OAUTH_HOST：コールバックサーバーのホストを設定
• OAUTH_PORT：コールバックサーバーのポートを設定

📄 ライセンス

MIT License