bitable-mcp

🚀 可etable MCP 服务器

本 MCP 服务器借助 Model Context Protocol 实现对 Lark Bitable 的访问。它使用户能够通过预定义工具与 Bitable 表格进行交互，为数据操作提供便利。

🚀 快速开始

一键式安装与配置

Claude

要安装并配置服务器，请使用以下命令：

PERSONAL_BASE_TOKEN=your_personal_base_token APP_TOKEN=your_app_token uv run --with uv --with bitable-mcp bitable-mcp-install

请将 your_personal_base_token 和 your_app_token 替换为您实际的令牌。

Cursor

即将推出

Windsurf

即将推出

手动安装与配置

请确保已安装 uvx 后再进行安装。

在 Claude 中配置

使用 uvx

"mcpServers": {
  "bitable-mcp": {
    "command": "uvx",
    "args": ["bitable-mcp"],
    "env": {
        "PERSONAL_BASE_TOKEN": "your-personal-base-token",
        "APP_TOKEN": "your-app-token"
    }
  }
}

使用 pip 安装

1. 通过 pip 安装 bitable-mcp：

pip install bitable-mcp

2. 修改您的 Claude 设置

"mcpServers": {
  "bitable-mcp": {
    "command": "python",
    "args": ["-m", "bitable_mcp"],
    "env": {
        "PERSONAL_BASE_TOKEN": "your-personal-base-token",
        "APP_TOKEN": "your-app-token"
    }
  }
}

配置 Zed

使用 uvx

"context_servers": [
  "bitable-mcp": {
    "command": "uvx",
    "args": ["bitable-mcp"],
    "env": {
        "PERSONAL_BASE_TOKEN": "your-personal-base-token",
        "APP_TOKEN": "your-app-token"
    }
  }
],

使用 pip 安装

"context_servers": {
  "bitable-mcp": {
    "command": "python",
    "args": ["-m", "bitable_mcp"],
    "env": {
        "PERSONAL_BASE_TOKEN": "your-personal-base-token",
        "APP_TOKEN": "your-app-token"
    }
  }
},

✨ 主要特性

可用工具

• list_table - 列出当前 Bitable 的表格。
  • 返回：一个 JSON 格式的表名列表。
• describe_table - 通过名称描述表格。
  • 参数：
    • name (str): 要描述的表格名称。
  • 返回：一个 JSON 格式的列列表。
• read_query - 执行 SQL 查询以从表格中读取数据。
  • 参数：
    • sql (str): 要执行的 SQL 查询。
  • 返回：一个 JSON 格式的查询结果列表。

🔧 调试

您可以使用 MCP 检查器来调试服务器。对于 uvx 安装：

npx @modelcontextprotocol/inspector uvx bitable-mcp