Lark MCP Server

Lark MCP サーバー

Lark／Feishu 向けの Model Context Protocol（MCP）サーバー実装です。MCP 対応アプリケーションが Lark のさまざまなコラボレーション機能を利用できるようにします。

概要

Lark MCP サーバーは、Model Context Protocol（MCP）の仕様を実装することで、AI モデルと Lark のコラボレーションプラットフォームをつなぎます。このサーバーを使うと、AI アシスタントは次の操作を行えます。

• Lark ユーザーにメッセージを送信する
• カレンダーの予定を取得する
• 新しいカレンダーの予定を作成する
• カレンダーの予定に参加者を追加する

このサーバーは標準入出力（stdio）トランスポート層を使用して MCP クライアントと通信するため、MCP 標準に対応するさまざまな AI モデル実装と互換性があります。

機能

• メッセージ送信：AI モデルから Lark ユーザーにダイレクトメッセージを送信できます
• カレンダー管理：
  • 指定した期間内の予定を一覧表示する
  • 詳細をカスタマイズして新しいカレンダーの予定を作成する
  • さまざまな種類の参加者（ユーザー、グループ、会議室、外部メールアドレス）を予定に追加する

前提条件

• Node.js v18 以降
• 適切な権限を持つ、登録済みの Lark／Feishu アプリケーション
• カレンダー操作用のユーザーアクセストークン

インストール

1. リポジトリをクローンします。

   git clone https://github.com/junyuan-qi/lark-mcp-server.git
   cd lark-mcp-server
   

2. 依存関係をインストールします。

   npm install
   

3. プロジェクトをビルドします。

   npm run build
   

使用方法

MCP クライアントとの接続

このサーバーは標準入出力（stdio）経由で通信します。MCP クライアントは、サーバーを子プロセスとして起動し、その標準入力／標準出力チャネルを介して通信することで接続できます。

Claude Desktop の設定

Claude Desktop アプリケーションで Lark MCP サーバーを認識して使用できるように設定することで、この MCP サーバーを統合できます。

1. Claude Desktop で Lark MCP サーバーを認識するように設定する

claude_desktop_config.json は、Claude Desktop アプリの設定内にあります。

1. Claude Desktop アプリを開き、左上のメニューバーから開発者モードを有効にします。
2. 有効にしたら、左上のメニューバーから設定を開き、「開発者向けオプション」に移動します。そこにある「設定を編集」ボタンをクリックすると、claude_desktop_config.json ファイルが開き、必要な編集を行えます。

または、ターミナルから claude_desktop_config.json を直接開くこともできます。

macOS の場合：

code ~/Library/Application\ Support/Claude/claude_desktop_config.json

Windows の場合：

code %APPDATA%\Claude\claude_desktop_config.json

2. Lark MCP サーバーの設定を追加する

claude_desktop_config.json の mcpServers セクションに、次の設定を追加します。

{
  "mcpServers": {
    "lark-mcp-server": {
      "command": "node",
      "args": ["/path/to/lark-mcp-server/build/index.js"],
      "env": {
        "LARK_APP_ID": "your_app_id",
        "LARK_APP_SECRET": "your_app_secret",
        "LARK_USER_ID": "target_user_id",
        "LARK_CALENDAR_ID": "target_calendar_id",
        "LARK_USER_ACCESS_TOKEN": "your_user_access_token"
      }
    }
  }
}

パスと環境変数を実際の値に置き換えてください。この設定により、Claude Desktop で Lark MCP サーバーを起動する方法と、渡す環境変数が指定されます。

3. Claude Desktop を再起動する

変更を反映するには、次の手順を行います。

1. Claude Desktop を完全に終了します（ウィンドウを閉じるだけでは不十分です）。
2. Claude Desktop を再び起動します。
3. UI にアイコンが表示され、Lark MCP サーバーが接続されていることを確認します。

接続すると、Claude がユーザーに代わって Lark ユーザーにメッセージを送信し、カレンダーの予定を管理できるようになります。

開発

プロジェクト構成

• src/index.ts：サーバーのメイン実装
• build/：コンパイル済み JavaScript ファイル
• package.json：プロジェクトの依存関係とスクリプト

ビルド

npm run build

このコマンドにより、TypeScript コードが build ディレクトリ内の JavaScript にコンパイルされ、実行権限が設定されます。

トラブルシューティング

詳細なエラー情報については、サーバーログ（標準エラー出力に書き込まれます）を確認してください。よくある問題は次のとおりです。

• 環境変数が設定されていない
• アクセストークンが正しくない、または期限切れである
• Lark アプリケーションの権限が不足している
• リクエストパラメーターが無効である

ライセンス

ISC

貢献

皆さまからの貢献を歓迎します。お気軽にプルリクエストを送信してください。

---

Model Context Protocol の詳細については、MCP ドキュメントをご覧ください。

Lark／Feishu API の詳細については、Lark Open Platform ドキュメントをご覧ください。