MCP Feishu Server

Exposes Feishu OpenAPI specs as MCP resources for Windsurf IDE integration.

typescript

0

GitHub Stars

typescript

Language

7 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "ningyv179-mcp-feishu": {
      "command": "node",
      "args": [
        "/Program Files/project/mcp-feishu/dist/index.js"
      ]
    }
  }
}

MCP Feishu Server delivers Feishu OpenAPI specifications as MCP resources for Windsurf IDE, enabling seamless API exploration, testing, and integration directly from your development environment.

How to use

You connect Windsurf IDE to the Feishu MCP server to fetch API projects and APIs, browse details, and test integrations right from your workspace.

In Windsurf IDE, configure a new MCP server using the provided local command. This creates a runtime bridge between Feishu OpenAPI data and your IDE’s MCP client, so you can discover, inspect, and work with Feishu APIs as MCP resources.

The server exposes these MCP resources for you to explore: api://projects (list all projects), api://projects/{projectId} (project details), api://projects/{projectId}/apis (APIs in a project), and api://projects/{projectId}/apis/{apiId} (API details). You can also use the included tools to access defect links and recently updated defects as part of API-related workflows.

To start using it locally, run the server, then connect from Windsurf IDE by selecting the Feishu MCP server you configured. After connection, you will see Feishu API resources appear under the MCP namespace in your IDE.

How to install

Prerequisites: Node.js and a package manager installed on your machine.

Clone the project, install dependencies, and build the server.

# Clone the repository
# git clone https://github.com/yourusername/mcp-feishu.git
# cd mcp-feishu

# Install dependencies
pnpm install

# Build the project
pnpm run build

Start the server in normal operation.

pnpm start

Debug the server with the inspector tool to connect a debugging session.

npx @modelcontextprotocol/inspector node dist/index.js

Connecting from Windsurf IDE

In Windsurf IDE settings, add a new MCP server with the runtime configuration shown below. This tells the IDE how to spawn the Feishu MCP server locally.

{
  "mcpServers": {
    "feiShuServer": {
      "command": "node",
      "args": ["/Program Files/project/mcp-feishu/dist/index.js"],
      "env": {
        "APP_ID": "",
        "APP_SECRET": "",
        "TABLE_ID": "",
        "APP_TOKEN": ""
      }
    }
  }
}