Feishu/lark

🚀 lark - mcp 使用ガイド

lark - mcpは、Feishu/LarkのAPI機能を簡単に利用できるようにするツールです。API代理、多言語対応、プラグイン拡張などの機能を備えています。

🚀 クイックスタート

lark - mcpを使用する前に、まずインストールする必要があります。以下の手順に従って操作してください。

📦 インストール

以下のコマンドを使用して、lark - mcpをグローバルにインストールできます。

npm install -g @larksuiteoapi/lark-mcp

特定のバージョンを指定する場合は、以下のコマンドを実行してください。

npm install -g @larksuiteoapi/lark-mcp@x.x.x # 具体的なバージョン番号に置き換えてください

コマンドの実行

インストールが完了したら、以下のコマンドを使用してMCPサービスを起動できます。

lark-mcp --app-id=<your_app_id> --app-secret=<your_app_secret>

デフォルトでは、MCPサービスはlocalhost:8092ポートで実行されます。

環境変数の設定

使いやすくするために、よく使うパラメータを環境変数で設定できます。

# 設定ファイルのパスを設定
export LARK_MCP_CONFIG="./config.json"

# アプリケーションIDとシークレットを設定
export LARK_APP_ID="your_app_id"
export LARK_APP_SECRET="your_app_secret"

# サービスを起動
lark-mcp

設定ファイルの例

{
  "app_id": "your_app_id",
  "app_secret": "your_app_secret",
  "port": 8092,
  "enableApis": ["im.v1.message.create", "im.v1.chat.create"]
}

✨ 主な機能

核心機能

• API代理：メッセージ作成からファイル管理まで、様々なAPI呼び出しをサポートします。
• 多言語対応：中国語と英語のバイリンガルインターフェースを提供し、異なるユーザーのニーズを満たします。
• プラグイン拡張：プラグイン形式でさらに多くの機能を拡張できます。

使用シーン

• 開発テスト：開発者がFeishu/LarkのAPI機能を迅速に統合するのを支援します。
• 企業アプリケーション：効率的な企業内部ツールやサービスを構築するために使用されます。
• 学習例：学習や教育の優れたケースリソースとして利用できます。

📚 ドキュメント

よくある質問

• 質問：Feishu/Lark APIに接続できません。

  • 回答：ネットワークが正常かどうかを確認し、APP_IDとAPP_SECRETが正しいことを確認してください。Feishu/Larkオープンプラットフォームにアクセスできることを確認し、必要に応じてプロキシサーバーを設定してください。

• 質問：user_access_tokenを使用するとエラーが発生します。

  • 回答：トークンが期限切れになっていないかを確認してください。通常、user_access_tokenの有効期限は2時間で、定期的に更新する必要があります。自動更新メカニズムを実装するか、app_access_tokenを使用することができます。

• 質問：MCPサービスを起動した後、一部のAPIを呼び出せず、権限不足のエラーが表示されます。

  • 回答：アプリケーションが関連するAPI権限を取得しているかを確認してください。一部のAPIには追加の高度な権限が必要で、オープンプラットフォームコンソールで設定して承認を得る必要があります。

• 質問：画像またはファイルのアップロード/ダウンロードに関連するAPI呼び出しが失敗します。

  • 回答：現在のバージョンでは、ファイルと画像のアップロード/ダウンロード機能はサポートされていません。将来のバージョンで段階的に改善される予定です。

関連リンク

• Feishuオープンプラットフォーム
• Lark国際版オープンプラットフォーム
• Feishu APIドキュメント
• Node.js公式サイト
• npmドキュメント

フィードバック

フィードバックを提供するか、問題を報告する場合は、以下の方法を使用してください。

• メール：support@larksuiteoapi.com
• GitHubリポジトリ：Issueを提出する