MCP Server My Lark Doc

MCP Server My Lark Doc

Lark（Feishu）ドキュメントを検索してアクセスするための Model Context Protocol サーバーです。

特長

ドキュメントコンテンツへのアクセス

• Lark Doc と Wiki の両方のドキュメントタイプに対応しています
• ドキュメントタイプの検出と ID の抽出を自動的に処理します
• LLM で処理できるよう、コンテンツをテキスト形式でそのまま返します

認証

• OAuth によるユーザー認証
• トークンの更新と有効期限の管理を自動で行います
• OAuth コールバックサーバーをカスタマイズできます

エラー処理

• 認証に関する問題を包括的に報告します
• 無効なドキュメント URL を明確に通知します
• トラブルシューティングに役立つ詳細なエラーメッセージを表示します

インストール

uvx mcp-server-my-lark-doc

設定

Lark の App ID と App Secret を取得する

Lark Open Platform にアクセスしてください：https://open.larkoffice.com/app

Lark アプリに以下の権限があることを確認してください

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

環境変数

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

1. Lark Open Platform で Lark アプリを作成します
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 callback server host (default: localhost)
export OAUTH_PORT="9997"                   # OAuth callback server port (default: 9997)

使用方法

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

"mcpServers": {
    "lark_doc": {
        "command": "uvx",
        "args": ["mcp-server-my-lark-doc"],
        "env": {
            "LARK_APP_ID": "your app id",
            "LARK_APP_SECRET": "your app secret",
            "OAUTH_HOST": "localhost",   // optional   
            "OAUTH_PORT": "9997"        // optional  
        }
    }
}

利用可能なツール

1. get_lark_doc_content

   • 目的：Lark からドキュメントの内容を取得します
   • 引数：documentUrl（string）- Lark ドキュメントの URL
   • 戻り値：テキスト形式のドキュメント内容
   • 対応形式：
     • Doc URL：https://xxx.feishu.cn/docx/xxxxx
     • Wiki URL：https://xxx.feishu.cn/wiki/xxxxx

2. search_wiki

   • 目的：Lark Wiki 内のドキュメントを検索します
   • 引数：
     • query（string）- 検索キーワード
     • page_size（int、任意）- 返す結果の数（デフォルト：10）
   • 戻り値：以下のフィールドを含む検索結果の JSON 文字列：
     • title：ドキュメントのタイトル
     • url：ドキュメントの URL
     • create_time：ドキュメントの作成時刻
     • update_time：ドキュメントの最終更新時刻

エラーメッセージ

よくあるエラーメッセージとその解決方法：

• "Lark client not properly initialized"：LARK_APP_ID と LARK_APP_SECRET を確認してください
• "Invalid Lark document URL format"：ドキュメント URL の形式を確認してください
• "Failed to get document content"：ドキュメントの権限とトークンの有効性を確認してください
• "Failed to get app access token"：アプリの認証情報とネットワーク接続を確認してください
• "Failed to get wiki document real ID"：Wiki ドキュメントが存在するか、適切な権限があるかを確認してください
• "Document content is empty"：ドキュメントが空であるか、コンテンツにアクセスできない可能性があります
• "Authorization timeout"：ユーザーが 5 分以内に認証を完了しませんでした

開発に関する注意事項

OAuth コールバックサーバー

デフォルト設定：

• ホスト：localhost

• ポート：9997 環境変数でカスタマイズできます：

• OAUTH_HOST：コールバックサーバーのホストを設定します

• OAUTH_PORT：コールバックサーバーのポートを設定します

ライセンス

MIT License