MCP Server My Lark Doc

🚀 MCP サーバー 私の飛書ドキュメント

このサーバーは、飛書（Lark）のドキュメントを検索し、アクセスするためのモデルコンテキストプロトコルサーバーです。

🚀 クイックスタート

このMCPサーバーを使用することで、飛書のドキュメントを簡単に検索し、アクセスできます。以下の手順に従って、サーバーをセットアップしてください。

✨ 主な機能

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

• 飛書ドキュメントとWikiの2種類のドキュメントタイプをサポートします。
• ドキュメントタイプの検出とIDの抽出を自動的に処理します。
• LLMで処理するための純粋なテキスト形式の内容を返します。

認証

• OAuthベースの認証をサポートします。
• トークンの期限切れを自動的に更新し、管理します。
• カスタマイズ可能なOAuthコールバックサーバーを提供します。

エラー処理

• 包括的な認証問題のエラーレポートを提供します。
• 無効なドキュメントURLに対する明確なフィードバックを提供します。
• トラブルシューティングに役立つ詳細なエラー情報を提供します。

📦 インストール

uvx mcp-server-my-lark-doc

📚 ドキュメント

設定

飛書アプリケーションIDとアプリケーションシークレットの取得

飛書オープンプラットフォームにアクセスしてください: https://open.larkoffice.com/app

飛書アプリケーションに必要な権限を確保する

wiki:wiki:readonly
wiki:node:read
docx:document:readonly
search:docs:read

環境変数の設定

このMCPサーバーを使用する前に、飛書アプリケーションの認証情報を設定する必要があります。

1. 飛書オープンプラットフォームで飛書アプリケーションを作成します。
2. あなたのApp IDとApp Secretを取得します。
3. 環境変数を設定します。

export LARK_APP_ID="your_app_id"
export LARK_APP_SECRET="your_app_secret"
export OAUTH_HOST="localhost"               # OAuthコールバックサーバーのホスト（デフォルト：localhost）
export OAUTH_PORT="9997"                   # OAuthコールバックサーバーのポート（デフォルト：9997）

使用方法

Claudeデスクトップで設定します。

"mcpServers": {
    "lark_doc": {
        "command": "uvx",
        "args": ["mcp-server-my-lark-doc"],
        "env": {
            "LARK_APP_ID": "あなたのアプリケーションID",
            "LARK_APP_SECRET": "あなたのアプリケーションシークレット",
            "OAUTH_HOST": "localhost",   // オプション  
            "OAUTH_PORT": "9997"        // オプション  
        }
    }
}

提供されているツール

1. get_lark_doc_content

   • 目的：飛書からドキュメント内容を取得します。
   • パラメータ：documentUrl (文字列) - 飛書ドキュメントのURL
   • 戻り値：テキスト形式のドキュメント内容
   • サポートするURL:
     • Doc URL: https://xxx.feishu.cn/docx/xxxxx
     • Wiki URL: https://xxx.feishu.cn/wiki/xxxxx

2. search_wiki

   • 目的：飛書Wikiでドキュメントを検索します。
   • パラメータ:
     • query (文字列) - 検索キーワード
     • page_size (整数、オプション) - 返される結果の数（デフォルト：10）
   • 戻り値: 検索結果を含むJSON文字列で、以下のフィールドを含みます。
     • title: ドキュメントのタイトル
     • url: ドキュメントのURL
     • create_time: ドキュメントの作成時間
     • update_time: ドキュメントの最後の更新時間

エラーメッセージ

一般的なエラーメッセージと解決策は次のとおりです。

• "飛書クライアントが正しく初期化されていません": あなたのLARK_APP_IDとLARK_APP_SECRETを確認してください。
• "無効な飛書ドキュメントURL形式": ドキュメントURLの形式を検証してください。
• "ドキュメント内容の取得に失敗しました": ドキュメントの権限とトークンの有効性を確認してください。
• "アプリケーションアクセストークンの取得に失敗しました": アプリケーションの認証情報とネットワーク接続を確認してください。
• "Wikiドキュメントの実際のIDの取得に失敗しました": Wikiドキュメントが存在し、適切な権限を持っていることを確認してください。
• "ドキュメント内容が空です": ドキュメントが空であるか、内容にアクセスする権限がない可能性があります。
• "認証がタイムアウトしました": サーバーが5分以内に認証を完了できませんでした。

開発上の注意事項

OAuthコールバックサーバー

デフォルト設定:

• ホスト: localhost
• ポート: 9997 環境変数でカスタマイズできます。
• OAUTH_HOST: コールバックサーバーのホストを設定します。
• OAUTH_PORT: コールバックサーバーのポートを設定します。

📄 ライセンス

MIT License