This MCP server implements a remote MCP with Feishu (Luo) OAuth integration. Users can authenticate via Feishu and connect through multiple clients to perform MCP tasks remotely. The server emphasizes zero-configuration workflows and token management, allowing clients like MCP Inspector, Cursor, and ChatWise to test and use the MCP tools without manual parameter juggling. You can inspect and test the server using the MCP Inspector, connect with Cursor to install and configure remote MCPs, or integrate through ChatWise for command-line style interactions that stream I/O through the MCP channels. The architecture is designed for Cloudflare Workers deployment with a Durable Objects-based MCP backend, supporting remote clients and standardized tool definitions. Ensure your Feishu app is configured with the required scopes and the OAuth redirect URL matches your deployment (production or local).

Prerequisites:

• Node.js 18+ and npm
• A Feishu Open Platform account and a Feishu OAuth app configured with the required permissions
• A Cloudflare Workers account (for production deployment) or local development setup as described

Install steps:

1. Clone the repository git clone <repository-url> cd open-feishu-mcp-server

2. Install dependencies npm install

3. Configure environment Create an environment file or set environment variables: FEISHU_APP_ID=your_feishu_app_id FEISHU_APP_SECRET=your_feishu_app_secret COOKIE_ENCRYPTION_KEY=any_random_string_here

4. Run in development mode (local) npm run dev

   The server will run at http://localhost:8788

5. Deploy production (Cloudflare Workers)

   • Ensure wrangler is installed and authenticated
   • Set required secrets (FEISHU_APP_ID, FEISHU_APP_SECRET, COOKIE_ENCRYPTION_KEY)
   • Configure wrangler.toml with your KV namespaces as instructed in the docs
   • Deploy: npm run deploy

6. After deployment, note the subdomain assigned by Wrangler and configure the Feishu OAuth redirect URL accordingly.

Tips and caveats:

• Ensure Feishu app permissions include: 获取用户 ID, 获取用户任务信息, 获取用户授权凭证, 获取用户基本信息, and the appropriate redirect URI for your environment.
• For local development, add the redirect URI http://localhost:8788/callback in Feishu app security settings.
• The server uses Feishu OAuth to authenticate users; ensure the OAuth flow is reachable from your clients' environments.
• When testing with MCP Inspector, use the inspector URL patterns provided in the docs for production or local environments.
• If you switch from local to production, update redirect URLs and secrets accordingly and re-deploy.