lark-base -node

This MCP server provides read and write access to Feishu Base databases, enabling LLMs to inspect schemas, read records, and perform create, update, and delete operations on tables and fields. After installing the server and obtaining the required tokens, configure the MCP with the provided mcpServers entry to run the node-based MCP server via npx. The server exposes a set of tools (list_tables, list_records, get_record, create_record, update_record, delete_record, create_table, update_table, delete_table, list_fields, create_field, update_field, and delete_field) that your MCP-enabled client can invoke to manage bases and their data. For Claude users, the README notes that MCP configuration should be added through the Claude client settings under Developer options, so ensure you follow that path if you’re integrating with Claude. In practice, you’ll supply your appToken and personalBaseToken as part of the command arguments to authorize access to your Feishu Base.

Prerequisites:

• Node.js and npm installed on your machine
• Access to the Feishu Base with appToken and personalBaseToken

Installation steps:

1. Install the MCP server package globally with npm:

npm install -g @lark-base-open/mcp-node-server

2. Create or update your MCP configuration file to include the server entry. Example:

{
  "mcpServers": {
    "base-mcp-server": {
      "command": "npx",
      "args": [
        "@lark-base-open/mcp-node-server",
        "-a",
        "appToken of base",
        "-p",
        "personalBaseToken of base"
      ]
    }
  }
}

3. Run the MCP server by loading the configuration in your MCP-compatible environment. If using Claude, add the MCP server details via the Claude Developer settings as described in the notes.
4. Verify that the server is reachable and test the available tools (list_tables, list_records, etc.) through your MCP client.

Tips and notes:

• Ensure you have valid appToken and personalBaseToken for your Feishu Base before starting the MCP server.
• The server uses the Feishu Base Node.js SDK and the Model Context Protocol SDK, so keep dependencies updated to avoid compatibility issues.
• If you are integrating with Claude, use the Developer options in Claude settings to add the MCP server, as mentioned in the README.
• Typical issues include token expiration or insufficient permissions on the base; regenerate tokens if necessary and verify scope/permissions.
• The command format relies on npx to fetch and run the server package; if you prefer a persistent installation, you can adapt to a local node_modules-based invocation or another package manager as appropriate.