feishu-user-plugin 1.0.0

package/.claude-plugin/plugin.json

@@ -0,0 +1,9 @@
+{
+  "name": "feishu-user-plugin",
+  "version": "1.0.0",
+  "description": "All-in-one Feishu plugin for Claude Code — send messages as yourself, read chats, manage docs/tables/wiki. 33 tools + 8 skills, 3 auth layers.",
+  "author": {
+    "name": "EthanQC"
+  },
+  "keywords": ["feishu", "lark", "claude-code", "plugin", "messaging", "im", "document", "bitable", "protobuf"]
+}

package/.env.example

@@ -0,0 +1,18 @@
+# === User Identity (reverse-engineered protocol) ===
+# Required for: send_as_user, send_to_user, send_to_group, search_contacts, etc.
+# How to get: Login to feishu.cn → Playwright context.cookies() or DevTools
+LARK_COOKIE=
+
+# === Official API (Feishu Open Platform) ===
+# Required for: read_messages, reply_message, docs, tables, wiki, drive, contacts
+# How to get: Create app at open.feishu.cn → get App ID and App Secret
+LARK_APP_ID=
+LARK_APP_SECRET=
+
+# === User OAuth UAT (optional, for P2P chat reading) ===
+# Required for: read_p2p_messages, list_user_chats
+# How to get: Run "node src/oauth.js" after configuring App ID/Secret above
+# These are auto-populated by the OAuth flow and auto-refreshed at runtime
+LARK_USER_ACCESS_TOKEN=
+LARK_USER_REFRESH_TOKEN=
+LARK_UAT_EXPIRES=

package/.mcp.json.example

@@ -0,0 +1,13 @@
+{
+  "mcpServers": {
+    "feishu-user-plugin": {
+      "command": "npx",
+      "args": ["-y", "feishu-user-plugin"],
+      "env": {
+        "LARK_COOKIE": "YOUR_FEISHU_COOKIE_HERE",
+        "LARK_APP_ID": "YOUR_APP_ID_HERE",
+        "LARK_APP_SECRET": "YOUR_APP_SECRET_HERE"
+      }
+    }
+  }
+}

package/CHANGELOG.md

@@ -0,0 +1,62 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/), and this project adheres to [Semantic Versioning](https://semver.org/).
+
+## [1.0.0] - 2026-03-09
+
+### Changed
+- Renamed from `feishu-user-mcp` to `feishu-user-plugin`
+- Converted to Claude Code Plugin standard structure (`.claude-plugin/`, `skills/`)
+- Skills moved from `.claude/commands/` to `skills/feishu-user-plugin/references/`
+- MCP server config template added (`.mcp.json`)
+- All client configurations now use `npx -y feishu-user-plugin`
+- Version reset to 1.0.0
+
+### Added
+- `.claude-plugin/plugin.json` — Plugin metadata
+- `skills/feishu-user-plugin/SKILL.md` — Main skill definition with allowed-tools
+- `skills/feishu-user-plugin/references/CLAUDE.md` — Troubleshooting guide
+
+### Fixed
+- Version number consistency across `package.json`, `src/index.js`, and `server.json`
+
+## [0.5.1] - 2026-03-08
+
+### Fixed
+- `search_docs` — SDK method `docx.builtin.search` does not exist; switched to `client.request()` with `/open-apis/suite/docs-api/search/object`
+- `search_wiki` — SDK method `wiki.node.search` does not exist; switched to suite docs search API
+- Message timestamp parsing — Feishu returns millisecond strings; added `_normalizeTimestamp()` to convert to seconds
+
+### Changed
+- Updated README to reflect all 33 tools with full documentation
+- Updated `server.json` manifest with complete tool list
+- Updated `.env.example` with UAT fields
+
+### Added
+- `src/test-all.js` — comprehensive test suite for all tools
+
+## [0.5.0] - 2026-03-06
+
+### Added
+- P2P (direct message) chat reading via `read_p2p_messages`
+- OAuth v2 authorization flow (`src/oauth.js`, `src/oauth-auto.js`)
+- `list_user_chats` — list all chats the user is in
+- Third auth layer: User OAuth UAT for P2P access
+- Auto-refresh of `user_access_token` with `.env` persistence
+
+## [0.4.0] - 2026-03-04
+
+### Added
+- Multi-type messaging: image, file, rich text (post), sticker, audio
+- Cookie heartbeat — auto-refresh CSRF every 4h to extend session
+- Chat name auto-resolution — pass group name instead of `oc_xxx` ID
+
+## [0.3.0] - 2026-03-01
+
+### Added
+- Initial release: 27 tools, 8 slash commands, dual backend
+- User identity messaging via reverse-engineered Protobuf protocol
+- Official API integration for docs, Bitable, wiki, drive, contacts
+- Support for Claude Code, Claude Desktop, Cursor, VS Code, Windsurf

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 EthanQC
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,473 @@
+# feishu-user-plugin
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+[![Node.js](https://img.shields.io/badge/Node.js-%3E%3D18-green.svg)](https://nodejs.org)
+[![MCP](https://img.shields.io/badge/MCP-Compatible-purple.svg)](https://modelcontextprotocol.io)
+[![Tools](https://img.shields.io/badge/Tools-33-orange.svg)](#tools-33-total)
+[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](CONTRIBUTING.md)
+
+**All-in-one Feishu/Lark MCP Server -- 33 tools, 8 skills, 3 auth layers for messaging, docs, tables, wiki, and drive.**
+
+The only MCP server that lets you send messages as your **personal identity** (not a bot), while also integrating the full official Feishu API for documents, spreadsheets, wikis, and more.
+
+## Highlights
+
+- **Send as yourself** -- Messages show your real name, not a bot. Supports text, rich text, images, files, stickers, and audio.
+- **Read everything** -- Group chats via bot API, P2P (direct messages) via OAuth UAT.
+- **Full Feishu suite** -- Docs, Bitable (spreadsheets), Wiki, Drive, Contacts -- all in one plugin.
+- **3 auth layers** -- Cookie-based user identity, app credentials (Official API), and OAuth UAT (P2P reading). Each is independent; configure only what you need.
+- **8 slash commands** for Claude Code -- `/send`, `/reply`, `/search`, `/digest`, `/doc`, `/table`, `/wiki`, `/status`
+- **Auto session management** -- Cookie heartbeat every 4h, UAT auto-refresh with token rotation.
+- **Chat name resolution** -- Pass a group name instead of `oc_xxx` ID; it resolves automatically.
+
+## Why This Exists
+
+Feishu's official API has a hard limitation: **there is no `send_as_user` scope**. Even with `user_access_token` (OAuth), messages still show `sender_type: "app"`.
+
+This project combines three auth layers into one plugin:
+
+```
+User Identity (cookie):     You -> Protobuf -> Feishu (messages appear as YOU)
+Official API  (app token):  You -> REST API -> Feishu (docs, tables, wiki, drive)
+User OAuth    (UAT):        You -> REST API -> Feishu (read P2P chats, list all chats)
+```
+
+**One plugin. Everything Feishu. No other MCP needed.**
+
+## Quick Start
+
+### Option 1: npx (recommended)
+
+```bash
+npx feishu-user-plugin
+```
+
+No installation needed. The package runs directly via npx.
+
+### Option 2: Clone and run locally
+
+```bash
+git clone https://github.com/EthanQC/feishu-user-plugin.git
+cd feishu-user-plugin
+npm install
+npm start
+```
+
+## Create Your Feishu App
+
+To use the Official API tools (docs, tables, wiki, drive, bot messaging), you need to create a Feishu app:
+
+### Step 1: Create the App
+
+1. Go to [Feishu Open Platform](https://open.feishu.cn/app) and log in
+2. Click **Create Custom App** (创建自建应用) -- you must choose **Custom App** (自建应用), NOT marketplace/third-party types
+3. Fill in the app name and description, then create it
+
+### Step 2: Enable Bot Capability
+
+1. In your app settings, go to **Add Capabilities** (添加应用能力)
+2. Enable **Bot** (机器人)
+
+### Step 3: Add Permissions (Scopes)
+
+Go to **Permissions & Scopes** (权限管理) and add the following scopes:
+
+| Scope | Purpose |
+|-------|---------|
+| `im:message` | Send messages as bot |
+| `im:message:readonly` | Read message history |
+| `im:chat:readonly` | List and read chats |
+| `docx:document` | Read and create documents |
+| `docx:document:readonly` | Read documents |
+| `bitable:record` | Read and write Bitable records |
+| `wiki:wiki:readonly` | Read wiki spaces and nodes |
+| `drive:drive:readonly` | List Drive files and folders |
+| `contact:user.id:readonly` | Look up users by email/mobile |
+
+> Add more scopes as needed depending on which tools you use.
+
+### Step 4: Get App Credentials
+
+1. Go to **Credentials & Basic Info** (凭证与基础信息)
+2. Copy the **App ID** (`cli_xxxxxxxxxxxx`) and **App Secret**
+3. Set them as `LARK_APP_ID` and `LARK_APP_SECRET` in your environment
+
+### Step 5: Publish and Approve
+
+1. **Create a version** and submit it for review (创建版本)
+2. Have your organization admin approve the app (管理员审核)
+3. After approval, the app is live
+
+### Step 6: Add Bot to Group Chats
+
+Add your bot to the group chats where you want it to read messages. The bot can only access chats it has been added to.
+
+## Environment Variables
+
+| Variable | Required For | Description |
+|----------|-------------|-------------|
+| `LARK_COOKIE` | User identity tools | Feishu web session cookie string. Needed for `send_to_user`, `send_to_group`, `search_contacts`, etc. |
+| `LARK_APP_ID` | Official API tools | App ID from Feishu Open Platform. Needed for `read_messages`, docs, tables, wiki, drive. |
+| `LARK_APP_SECRET` | Official API tools | App Secret from Feishu Open Platform. Used together with `LARK_APP_ID`. |
+| `LARK_USER_ACCESS_TOKEN` | P2P chat reading | OAuth user token. Needed for `read_p2p_messages` and `list_user_chats`. Obtained via `node src/oauth.js`. |
+
+Each auth layer is independent. You can configure:
+- **Cookie only** -- for sending messages as yourself
+- **App credentials only** -- for reading docs, tables, wiki, group chats
+- **All three** -- for the full feature set
+
+## How to Get Your Cookie
+
+**Option A: Automated via Playwright MCP (recommended, zero manual copying)**
+
+First, install Playwright MCP if you don't have it:
+```bash
+npx @anthropic-ai/claude-code mcp add playwright -- npx @anthropic-ai/mcp-server-playwright
+```
+
+Then just tell Claude Code: **"Help me set up my Feishu cookie"**
+
+Claude Code will automatically:
+1. Open feishu.cn in a browser via Playwright
+2. Show you the QR code — scan it with Feishu mobile app
+3. Extract the full cookie (including HttpOnly) via `context.cookies()`
+4. Write it to your `.mcp.json` LARK_COOKIE field
+5. Prompt you to restart Claude Code
+
+**Option B: Manual (via Network tab)**
+
+1. Open [feishu.cn/messenger](https://www.feishu.cn/messenger/) in your browser and log in
+2. Open DevTools (`F12` or `Cmd+Option+I`)
+3. Go to the **Network** tab → check **Disable cache** → press `Cmd+R` to reload
+4. Click the first request in the list (usually the page itself)
+5. In the right panel, find **Request Headers** → **Cookie:** → right-click → **Copy value**
+6. Set it as `LARK_COOKIE` in your environment
+
+> Do NOT use `document.cookie` in the Console or copy from Application → Cookies tab — they miss HttpOnly cookies (`session`, `sl_session`) required for auth.
+
+> The server automatically refreshes the session via heartbeat every 4 hours. The `sl_session` cookie has a 12-hour max-age.
+
+## How to Set Up P2P Chat Reading (OAuth)
+
+To read direct message history with `read_p2p_messages` and `list_user_chats`:
+
+1. Your Feishu app must be a **Custom App** (自建应用), NOT marketplace/third-party
+2. Add scopes: `im:message`, `im:message:readonly`, `im:chat:readonly`
+3. In your app's **Security Settings** (安全设置), add the OAuth redirect URI: `http://127.0.0.1:9997/callback`
+4. **Important**: Make sure "对外共享" (external sharing) is **disabled** in your app version settings — enabling it marks the app as b2c/b2b type, which blocks P2P chat access
+5. Run the authorization flow:
+
+```bash
+# If you cloned the repo:
+node src/oauth.js
+
+# If you installed via npx:
+cd $(npm root -g)/feishu-user-plugin && node src/oauth.js
+# Or clone the repo just for the OAuth step, then use npx for daily use
+```
+
+A browser window will open for OAuth consent. The token is saved to `.env` automatically and auto-refreshes at runtime. Add the resulting `LARK_USER_ACCESS_TOKEN` to your `.mcp.json` env.
+
+## MCP Client Configuration
+
+### Claude Code
+
+Add to your project's `.mcp.json` (or `~/.claude/.mcp.json` for global):
+
+**Using npx:**
+
+```json
+{
+  "mcpServers": {
+    "feishu": {
+      "command": "npx",
+      "args": ["-y", "feishu-user-plugin"],
+      "env": {
+        "LARK_COOKIE": "your-cookie-string",
+        "LARK_APP_ID": "cli_xxxxxxxxxxxx",
+        "LARK_APP_SECRET": "your-app-secret"
+      }
+    }
+  }
+}
+```
+
+**Using a local clone:**
+
+```json
+{
+  "mcpServers": {
+    "feishu": {
+      "command": "node",
+      "args": ["/absolute/path/to/feishu-user-plugin/src/index.js"],
+      "env": {
+        "LARK_COOKIE": "your-cookie-string",
+        "LARK_APP_ID": "cli_xxxxxxxxxxxx",
+        "LARK_APP_SECRET": "your-app-secret"
+      }
+    }
+  }
+}
+```
+
+Then just say things like:
+- "Send a message to Alice saying the meeting is at 3pm"
+- "What did the engineering group chat about today?"
+- "Search for docs about MCP"
+
+### Claude Desktop
+
+Add to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows):
+
+```json
+{
+  "mcpServers": {
+    "feishu": {
+      "command": "npx",
+      "args": ["-y", "feishu-user-plugin"],
+      "env": {
+        "LARK_COOKIE": "your-cookie-string",
+        "LARK_APP_ID": "cli_xxxxxxxxxxxx",
+        "LARK_APP_SECRET": "your-app-secret"
+      }
+    }
+  }
+}
+```
+
+### Cursor
+
+Add to `.cursor/mcp.json` in your project:
+
+```json
+{
+  "mcpServers": {
+    "feishu": {
+      "command": "npx",
+      "args": ["-y", "feishu-user-plugin"],
+      "env": {
+        "LARK_COOKIE": "your-cookie-string",
+        "LARK_APP_ID": "cli_xxxxxxxxxxxx",
+        "LARK_APP_SECRET": "your-app-secret"
+      }
+    }
+  }
+}
+```
+
+### VS Code (Copilot)
+
+Add to `.vscode/mcp.json` in your project:
+
+```json
+{
+  "servers": {
+    "feishu": {
+      "type": "stdio",
+      "command": "npx",
+      "args": ["-y", "feishu-user-plugin"],
+      "env": {
+        "LARK_COOKIE": "your-cookie-string",
+        "LARK_APP_ID": "cli_xxxxxxxxxxxx",
+        "LARK_APP_SECRET": "your-app-secret"
+      }
+    }
+  }
+}
+```
+
+### Windsurf
+
+Add to `~/.codeium/windsurf/mcp_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "feishu": {
+      "command": "npx",
+      "args": ["-y", "feishu-user-plugin"],
+      "env": {
+        "LARK_COOKIE": "your-cookie-string",
+        "LARK_APP_ID": "cli_xxxxxxxxxxxx",
+        "LARK_APP_SECRET": "your-app-secret"
+      }
+    }
+  }
+}
+```
+
+## Tools (33 total)
+
+### User Identity -- Messaging (cookie auth, Protobuf)
+
+Send messages as yourself, not as a bot.
+
+| Tool | Description |
+|------|-------------|
+| `send_to_user` | Search user by name + send text -- one step |
+| `send_to_group` | Search group by name + send text -- one step |
+| `send_as_user` | Send text to any chat by ID, supports reply threading (`root_id` / `parent_id`) |
+| `send_image_as_user` | Send image (requires `image_key` from upload) |
+| `send_file_as_user` | Send file (requires `file_key` from upload) |
+| `send_post_as_user` | Send rich text with title + formatted paragraphs (links, @mentions) |
+| `send_sticker_as_user` | Send sticker/emoji |
+| `send_audio_as_user` | Send audio message |
+
+### User Identity -- Contacts & Info (cookie auth)
+
+| Tool | Description |
+|------|-------------|
+| `search_contacts` | Search users, bots, or group chats by name |
+| `create_p2p_chat` | Create/get P2P (direct message) chat, returns numeric `chat_id` |
+| `get_chat_info` | Group details: name, description, member count, owner |
+| `get_user_info` | User display name lookup by user ID |
+| `get_login_status` | Check cookie, app credentials, and UAT status |
+
+### User OAuth UAT -- P2P Chat Reading
+
+| Tool | Description |
+|------|-------------|
+| `read_p2p_messages` | Read P2P (direct message) history. Works for chats the bot cannot access. |
+| `list_user_chats` | List all chats the user is in, including P2P. |
+
+### Official API -- IM (Bot Identity)
+
+| Tool | Description |
+|------|-------------|
+| `list_chats` | List all chats the bot has joined |
+| `read_messages` | Read message history (accepts chat name or `oc_xxx` ID) |
+| `reply_message` | Reply to a specific message by `message_id` (as bot) |
+| `forward_message` | Forward a message to another chat |
+
+### Official API -- Documents
+
+| Tool | Description |
+|------|-------------|
+| `search_docs` | Search documents by keyword |
+| `read_doc` | Read raw text content of a document |
+| `create_doc` | Create a new document |
+
+### Official API -- Bitable (Spreadsheets)
+
+| Tool | Description |
+|------|-------------|
+| `list_bitable_tables` | List all tables in a Bitable app |
+| `list_bitable_fields` | List all fields (columns) in a table |
+| `search_bitable_records` | Query records with filter and sort |
+| `create_bitable_record` | Create a new record (row) |
+| `update_bitable_record` | Update an existing record |
+
+### Official API -- Wiki
+
+| Tool | Description |
+|------|-------------|
+| `list_wiki_spaces` | List all accessible wiki spaces |
+| `search_wiki` | Search wiki/docs by keyword |
+| `list_wiki_nodes` | Browse wiki node tree |
+
+### Official API -- Drive
+
+| Tool | Description |
+|------|-------------|
+| `list_files` | List files in a folder |
+| `create_folder` | Create a new folder |
+
+### Official API -- Contacts
+
+| Tool | Description |
+|------|-------------|
+| `find_user` | Find user by email or mobile number |
+
+## Claude Code Slash Commands (8 skills)
+
+This plugin includes 8 built-in skills in `skills/feishu-user-plugin/`:
+
+| Skill | Usage | Description |
+|-------|-------|-------------|
+| `/send` | `/send Alice: meeting at 3pm` | Send message as yourself |
+| `/reply` | `/reply engineering-chat` | Read recent messages and reply |
+| `/digest` | `/digest engineering-chat 7` | Summarize recent chat messages |
+| `/search` | `/search engineering` | Search contacts and groups |
+| `/doc` | `/doc search MCP` | Search, read, or create documents |
+| `/table` | `/table query appXxx` | Query or create Bitable records |
+| `/wiki` | `/wiki search protocol` | Search and browse wiki |
+| `/status` | `/status` | Check login and auth status |
+
+Skills are automatically available when the plugin is installed.
+
+## Architecture
+
+```
+                               Cookie + Proto   ┌──────────────────────────────────────┐
+                             ────────────────── >│  internal-api-lark-api.feishu.cn     │
+┌──────────────┐                                 │  /im/gateway/ (Protobuf over HTTP)   │
+│  MCP Client  │                                 └──────────────────────────────────────┘
+│  (Claude,    │  App Token (REST) ┌──────────────────────────────────────┐
+│   Cursor,    │ ────────────────->│  open.feishu.cn/open-apis/           │
+│   VS Code)   │                   │  (Official REST API)                 │
+│              │                   └──────────────────────────────────────┘
+│              │  User OAuth (REST)┌──────────────────────────────────────┐
+│              │ ────────────────->│  open.feishu.cn/open-apis/           │
+└──────────────┘                   │  (UAT -- P2P chat reading)           │
+                                   └──────────────────────────────────────┘
+```
+
+## Session & Token Lifecycle
+
+| Auth Layer | Token | Lifetime | Refresh |
+|------------|-------|----------|---------|
+| Cookie | `sl_session` | 12h max-age | Auto-refreshed every 4h via heartbeat |
+| App Token | `tenant_access_token` | 2h | Auto-managed by SDK |
+| User OAuth | `user_access_token` | ~2h | Auto-refreshed via `refresh_token`, saved to `.env` |
+
+When the cookie expires (after ~12-24h without heartbeat), re-login at feishu.cn and update `LARK_COOKIE`. Use `get_login_status` to check health proactively.
+
+## Project Structure
+
+```
+feishu-user-plugin/
+├── .claude-plugin/
+│   └── plugin.json          # Plugin metadata
+├── skills/
+│   └── feishu-user-plugin/
+│       ├── SKILL.md         # Main skill definition (trigger, tools, auth)
+│       └── references/      # 8 skill reference docs + CLAUDE.md
+├── src/
+│   ├── index.js             # MCP server entry point (33 tools)
+│   ├── client.js            # User identity client (Protobuf gateway)
+│   ├── official.js          # Official API client (REST, UAT)
+│   ├── utils.js             # ID generators, cookie parser
+│   ├── oauth.js             # OAuth flow for user_access_token
+│   ├── test-send.js         # Quick CLI test
+│   └── test-all.js          # Full test suite
+├── proto/
+│   └── lark.proto           # Protobuf message definitions
+├── .mcp.json.example        # MCP server config template
+├── server.json              # MCP Registry manifest
+├── .env.example             # Configuration template
+└── package.json
+```
+
+## Limitations
+
+- Cookie-based auth requires periodic refresh (auto-heartbeat extends to ~12h; manual re-login needed after that)
+- Depends on Feishu's internal Protobuf protocol -- may break if Feishu updates their web client
+- Image/file/audio sending requires pre-uploaded keys (upload via Official API or external bridge)
+- No real-time message receiving (WebSocket push not yet implemented)
+- May violate Feishu's Terms of Service -- use at your own risk
+
+## Contributing
+
+Issues and PRs welcome! See [CONTRIBUTING.md](CONTRIBUTING.md) for development setup, code style, and submission guidelines.
+
+If Feishu updates their protocol and something breaks, please [open an issue](https://github.com/EthanQC/feishu-user-plugin/issues/new?template=bug_report.md) with the error details.
+
+## License
+
+[MIT](LICENSE)
+
+## Acknowledgments
+
+- [cv-cat/LarkAgentX](https://github.com/cv-cat/LarkAgentX) -- Original Feishu protocol reverse-engineering (Python)
+- [cv-cat/OpenFeiShuApis](https://github.com/cv-cat/OpenFeiShuApis) -- Underlying API research
+- [Model Context Protocol](https://modelcontextprotocol.io) -- The MCP standard

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "feishu-user-plugin",
+  "version": "1.0.0",
+  "description": "All-in-one Feishu plugin for Claude Code — send messages as yourself, read chats, manage docs/tables/wiki. 33 tools + 8 skills, 3 auth layers.",
+  "main": "src/index.js",
+  "bin": {
+    "feishu-user-plugin": "src/index.js"
+  },
+  "scripts": {
+    "start": "node src/index.js",
+    "test": "node src/test-all.js",
+    "test:quick": "node src/test-send.js",
+    "oauth": "node src/oauth.js"
+  },
+  "keywords": [
+    "feishu",
+    "lark",
+    "claude-code",
+    "plugin",
+    "mcp",
+    "model-context-protocol",
+    "im",
+    "messaging",
+    "protobuf",
+    "agent"
+  ],
+  "author": "EthanQC",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/EthanQC/feishu-user-plugin.git"
+  },
+  "homepage": "https://github.com/EthanQC/feishu-user-plugin#readme",
+  "bugs": {
+    "url": "https://github.com/EthanQC/feishu-user-plugin/issues"
+  },
+  "files": [
+    "src/",
+    "proto/",
+    ".claude-plugin/",
+    "skills/",
+    ".mcp.json.example",
+    ".env.example",
+    "CHANGELOG.md",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "@larksuiteoapi/node-sdk": "^1.59.0",
+    "@modelcontextprotocol/sdk": "^1.12.1",
+    "dotenv": "^16.4.7",
+    "protobufjs": "^7.4.0"
+  }
+}