Provides a Node.js-based MCP server that encapsulates Feishu/Lark Open Platform API interfaces, allowing AI assistants to directly call these interfaces for various automation scenarios.
Englisch |中文
Abruf der Entwicklerdokumentation MCP | Offizielles Dokument
⚠️ Hinweis zur Beta-Version : Dieses Tool befindet sich derzeit in der Beta-Phase. Funktionen und APIs können sich ändern. Bleiben Sie daher über die neuesten Versionen auf dem Laufenden.
Dies ist das offizielle OpenAPI MCP-Tool (Model Context Protocol) von Feishu/Lark. Es ermöglicht Benutzern eine schnelle Verbindung zur Feishu/Lark-Plattform und ermöglicht eine effiziente Zusammenarbeit zwischen KI-Agenten und Feishu/Lark. Das Tool kapselt die API-Schnittstellen der Feishu/Lark Open Platform als MCP-Tools. KI-Assistenten können diese Schnittstellen direkt aufrufen und verschiedene Automatisierungsszenarien wie Dokumentenverarbeitung, Konversationsmanagement, Kalenderplanung und mehr implementieren.
Eine vollständige Liste aller unterstützten Feishu/Lark-Tools finden Sie in tools.md , wo die Tools nach Projekt und Version mit Beschreibungen kategorisiert sind.
Bevor Sie das Lark-MCP-Tool verwenden, müssen Sie eine Feishu/Lark-Anwendung erstellen:
Ausführliche Richtlinien zur Anwendungserstellung und -konfiguration finden Sie in der Feishu Open Platform-Dokumentation – Erstellen einer Anwendung oder in der Lark Open Platform-Dokumentation .
Bevor Sie das Tool Lark-MCP verwenden, müssen Sie die Node.js-Umgebung installieren.
Installieren Sie das Tool Lark-MCP global:
Um die Feishu/Lark-Funktionalität in KI-Tools wie Trae，Cursor oder Claude zu integrieren, fügen Sie Ihrer Konfigurationsdatei Folgendes hinzu:
Um mit der Benutzeridentität auf APIs zuzugreifen, können Sie ein Benutzerzugriffstoken hinzufügen:
Standardmäßig aktiviert der MCP-Dienst allgemeine APIs. Um andere Tools oder nur bestimmte APIs oder Voreinstellungen zu aktivieren, können Sie diese mit dem Parameter -t (durch Kommas getrennt) angeben:
In der folgenden Tabelle sind die einzelnen API-Tools und ihre Einbindung in die verschiedenen Vorgabesammlungen detailliert aufgeführt. So können Sie die passende Vorgabe für Ihre Anforderungen auswählen:
| Werkzeugname | Funktionsbeschreibung | preset.default (Standard) | Vorgabe.im.default | Vorgabe.Basis.Standard | Vorgabe.Basis.Batch | voreingestellt.doc.default | voreingestellt.task.default | Vorgabe.Kalender.Standard |
|---|---|---|---|---|---|---|---|---|
| im.v1.chat.create | Erstellen eines Gruppenchats | ✓ | ✓ | |||||
| im.v1.chat.list | Gruppenchatliste abrufen | ✓ | ✓ | |||||
| im.v1.chatMembers.get | Gruppenmitglieder abrufen | ✓ | ✓ | |||||
| im.v1.chatMembers.create | Gruppenmitglieder hinzufügen | ✓ | ✓ | |||||
| im.v1.message.create | Nachrichten senden | ✓ | ✓ | |||||
| im.v1.message.list | Nachrichtenliste abrufen | ✓ | ✓ | |||||
| bitable.v1.app.create | Basis erstellen | ✓ | ✓ | ✓ | ||||
| bitable.v1.appTable.create | Basisdatentabelle erstellen | ✓ | ✓ | ✓ | ||||
| bitable.v1.appTable.list | Holen Sie sich die Basisdatentabellenliste | ✓ | ✓ | ✓ | ||||
| bitable.v1.appTableField.list | Holen Sie sich die Feldliste der Basisdatentabelle | ✓ | ✓ | ✓ | ||||
| bitable.v1.appTableRecord.search | Suchen Sie nach Datensätzen in der Basisdatentabelle | ✓ | ✓ | ✓ | ||||
| bitable.v1.appTableRecord.create | Erstellen von Basisdatentabellendatensätzen | ✓ | ✓ | |||||
| bitable.v1.appTableRecord.batchCreate | Erstellen Sie im Stapelbetrieb Datensätze aus der Basisdatentabelle | ✓ | ✓ | |||||
| bitable.v1.appTableRecord.update | Aktualisieren der Datensätze der Basisdatentabelle | ✓ | ✓ | |||||
| bitable.v1.appTableRecord.batchUpdate | Stapelaktualisierung der Datensätze der Basisdatentabelle | ✓ | ✓ | |||||
| docx.v1.document.rawContent | Dokumentinhalte abrufen | ✓ | ✓ | |||||
| docx.builtin.import | Dokumente importieren | ✓ | ✓ | |||||
| docx.builtin.search | Dokumente suchen | ✓ | ✓ | |||||
| drive.v1.permissionMember.create | Berechtigungen für Mitarbeiter hinzufügen | ✓ | ✓ | |||||
| wiki.v2.space.getNode | Wiki-Knoten abrufen | ✓ | ✓ | |||||
| wiki.v1.node.search | Wiki-Knoten durchsuchen | ✓ | ✓ | |||||
| contact.v3.user.batchGetId | Batch-Abruf von Benutzer-IDs | ✓ | ||||||
| task.v2.task.create | Aufgabe erstellen | ✓ | ||||||
| task.v2.task.patch | Aufgabe ändern | ✓ | ||||||
| task.v2.task.addMembers | Aufgabenmitglieder hinzufügen | ✓ | ||||||
| task.v2.task.addReminders | Aufgabenerinnerungen hinzufügen | ✓ | ||||||
| calendar.v4.calendarEvent.create | Kalenderereignis erstellen | ✓ | ||||||
| calendar.v4.calendarEvent.patch | Kalenderereignis ändern | ✓ | ||||||
| calendar.v4.calendarEvent.get | Kalenderereignis abrufen | ✓ | ||||||
| calendar.v4.freebusy.list | Frei/Gebucht-Status abfragen | ✓ | ||||||
| calendar.v4.calendar.primary | Primärkalender abrufen | ✓ |
Hinweis : In der Tabelle zeigt „✓“ an, dass das Werkzeug in dieser Voreinstellung enthalten ist. Mit
-t preset.xxxwerden nur die Werkzeuge aktiviert, die in der entsprechenden Spalte mit „✓“ gekennzeichnet sind.
Das lark-mcp mcp bietet verschiedene Befehlszeilenparameter für eine flexible MCP-Dienstkonfiguration:
| Parameter | Kurz | Beschreibung | Beispiel |
|---|---|---|---|
--app-id | -a | App-ID der Feishu/Lark-Anwendung | -a cli_xxxx |
--app-secret | -s | App-Geheimnis der Feishu/Lark-Anwendung | -s xxxx |
--domain | -d | Feishu/Lark API-Domäne, Standard ist https://open.feishu.cn | -d https://open.larksuite.com |
--tools | -t | Liste der zu aktivierenden API-Tools, durch Kommas getrennt | -t im.v1.message.create,im.v1.chat.create |
--tool-name-case | -c | Werkzeugnamenformat, Optionen sind Schlange, Kamel, Punkt oder Kebab, Standard ist Schlange | -c camel |
--language | -l | Sprache der Tools, Optionen sind zh oder en, Standard ist en | -l zh |
--user-access-token | -u | Benutzerzugriffstoken zum Aufrufen von APIs als Benutzer | -u u-xxxx |
--token-mode | API-Token-Typ, Optionen sind „auto“, „tenant_access_token“ oder „user_access_token“, Standard ist „auto“ | --token-mode user_access_token | |
--mode | -m | Transportmodus, Optionen sind stdio oder sse, Standard ist stdio | -m sse |
--host | Listening-Host im SSE-Modus, Standard ist localhost | --host 0.0.0.0 | |
--port | -p | Abhörport im SSE-Modus, Standard ist 3000 | -p 3000 |
--config | Konfigurationsdateipfad, unterstützt JSON-Format | --config ./config.json | |
--version | -V | Versionsnummer anzeigen | -V |
--help | -h | Hilfeinformationen anzeigen | -h |
Hinweis : Benutzerzugriffstoken können über den Autorisierungsprozess der Feishu Open Platform oder der Lark Open Platform oder über die API-Debugging-Konsole abgerufen werden. Nach Verwendung eines Benutzerzugriffstokens werden API-Aufrufe mit der Identität dieses Benutzers ausgeführt.
Hinweis : Mit dieser Option können Sie explizit angeben, welcher Token-Typ beim Aufruf von APIs verwendet werden soll. Der
autoModus (Standard) wird vom LLM beim Aufruf der API festgelegt.
Hinweis : Der Parameter
-tunterstützt die folgenden voreingestellten Werkzeugsammlungen:
preset.default– Standard-Werkzeugsatz mit allen voreingestellten Werkzeugenpreset.im.default– Tools für Instant Messaging, wie Gruppenverwaltung, Nachrichtenversand usw.preset.bitable.default– Bitable-bezogene Tools, wie Tabellenerstellung, Datensatzverwaltung usw.preset.bitable.batch– Bitable-Batchoperationstools, einschließlich Batch-Erstellungs- und Aktualisierungsfunktionen für Datensätzepreset.doc.default– Dokumentbezogene Tools, wie z. B. Lesen von Dokumentinhalten, Berechtigungsverwaltung usw.preset.task.default– Tools zur Aufgabenverwaltung, wie Aufgabenerstellung, Mitgliederverwaltung usw.preset.calendar.default– Tools zur Verwaltung von Kalenderereignissen, z. B. Erstellen von Kalenderereignissen, Abfragen des Frei/Gebucht-Status usw.
Hinweis : Wenn Sie die Sprache auf Chinesisch (
-l zh) einstellen, werden möglicherweise mehr Token verbraucht. Sollten bei der Integration großer Sprachmodelle Probleme mit der Token-Begrenzung auftreten, sollten Sie die englische Standardeinstellung (-l en) verwenden.
Hinweis : Durch Festlegen des Werkzeugnamenformats können Sie die Anzeige von Werkzeugnamen im MCP ändern. Beispiel:
im.v1.message.createin verschiedenen Formaten:
- Snake-Format (Standard):
im_v1_message_create- Kamelformat:
imV1MessageCreate- Kebab-Format:
im-v1-message-create- Punktformat:
im.v1.message.create
Neben Befehlszeilenparametern können Sie zum Festlegen von Parametern auch eine Konfigurationsdatei im JSON-Format verwenden:
Beispiel einer Konfigurationsdatei (config.json):
Hinweis : Befehlszeilenparameter haben eine höhere Priorität als die Konfigurationsdatei. Wenn Sie sowohl Befehlszeilenparameter als auch eine Konfigurationsdatei verwenden, überschreiben die Befehlszeilenparameter die entsprechenden Einstellungen in der Konfigurationsdatei.
lark-mcp unterstützt zwei Transportmodi:
Nach dem Start ist der SSE-Endpunkt unter http://<host>:<port>/sse erreichbar.
chcp 65001 ausführen. Bei Verwendung von PowerShell müssen Sie möglicherweise die Terminalschriftart oder die PowerShell-Konfiguration ändern.sudo npm install -g @larksuiteoapi/lark-mcp für die Installation oder ändern Sie die Berechtigungen des globalen npm-Installationspfads. Windows-Benutzer können versuchen, die Eingabeaufforderung als Administrator auszuführen.-t die Anzahl der aktivierten APIs zu reduzieren, oder verwenden Sie ein Modell, das größere Token unterstützt (z. B. claude3.7).Wir freuen uns über Ihre Rückmeldungen, um dieses Tool zu verbessern. Wenn Sie Fragen oder Anregungen haben, stellen Sie diese bitte im GitHub-Repository.
This server cannot be installed
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Ein Toolkit, das es KI-Assistenten ermöglicht, Feishu/Lark-API-Schnittstellen für Automatisierungsszenarien wie Dokumentenverarbeitung, Konversationsverwaltung und Kalenderplanung direkt aufzurufen.