jiang-feishu-mcp logo

jiang-feishu-mcp

by upJiang

A Model Context Protocol (MCP) server for connecting to Feishu documents, allowing direct access to Feishu document spaces and document lists within AI clients like Cursor. It enables seamless integration with AI applications through the MCP protocol.

View on GitHub

Last updated: N/A

What is jiang-feishu-mcp?

This is a Model Context Protocol (MCP) server that bridges Feishu documents with AI clients like Cursor. It allows AI applications to directly access and interact with Feishu document spaces and documents.

How to use jiang-feishu-mcp?

  1. Clone the repository and install dependencies using pnpm. 2. Configure Feishu application credentials in a .env file. 3. Start the server. 4. In Cursor, add a new MCP server with the URL http://localhost:7777/mcp. 5. Use the provided tools like list-spaces and list-documents within Cursor to interact with Feishu documents.

Key features of jiang-feishu-mcp

  • Supports fetching all Feishu cloud document space lists

  • Supports fetching document lists for specified spaces

  • Seamless connection with AI clients via MCP protocol

  • Uses Node.js and TypeScript for development

  • Utilizes Feishu Open API to access document content

Use cases of jiang-feishu-mcp

  • Listing all Feishu document spaces within an AI client

  • Listing documents within a specific Feishu document space

  • Integrating Feishu document access into AI-powered workflows

  • Enabling AI to understand and process information from Feishu documents

FAQ from jiang-feishu-mcp

What is MCP?

MCP (Model Context Protocol) is a protocol that allows seamless connection between custom services and various LLM clients, enabling AI to directly call and use service functionalities.

What is an MCP Client?

An MCP Client is an AI application (e.g., Claude Desktop or Cursor) that initiates requests and communicates with the MCP server.

How do I get Feishu application credentials?

  1. Visit the Feishu Open Platform and log in. 2. Create an enterprise self-built application. 3. Obtain the App ID and App Secret from the application details page. 4. Ensure that cloud document-related permissions (document, spreadsheet, cloud space read permissions) are enabled.

What technologies are used in this project?

This project uses Node.js, TypeScript, MCP SDK, Express, and the Feishu Open API.

What permissions are required for the Feishu application?

The application needs to have access to Feishu cloud documents.