多维表格服务器

基于Nuxt和TypeScript的飞书多维表格MCP服务器,提供多维表格数据管理功能。

  • by 011011100
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 011011100/feishu-mcp

使用说明

Feishu Bitable MCP Server

基于 Nuxt + TypeScript 的飞书多维表格 MCP 服务器。

功能

  • 列出多维表格中的所有数据表
  • 读取数据表记录
  • 搜索记录
  • 按名称搜索多维表格
  • 获取数据表视图

安装

# 安装依赖
pnpm install

# 复制环境变量配置
cp .env.example .env

# 编辑 .env,填入你的飞书应用凭证

配置

在 .env 文件中配置:

FEISHU_APP_ID=cli_xxxxxxxxxxxxxxxx
FEISHU_APP_SECRET=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

获取方式:

  1. 访问 飞书开放平台
  2. 创建企业自建应用
  3. 开启 "多维表格" 权限
  4. 获取 App ID 和 App Secret

使用

作为 MCP 服务器运行

pnpm mcp

然后在 Claude Code 的 .claude.json 中配置:

{
  "mcpServers": {
    "feishu-bitable": {
      "command": "node",
      "args": ["--import", "tsx", "C:/Users/1/Desktop/feishu-mcp/server/mcp/index.ts"],
      "env": {
        "FEISHU_APP_ID": "cli_xxxxxxxxxxxxxxxx",
        "FEISHU_APP_SECRET": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

开发模式

pnpm dev

MCP 工具列表

工具名 说明
list_bitable_tables 获取多维表格中的所有数据表
list_bitable_records 读取数据表记录
search_bitable_records 搜索记录
search_bitable_apps 按名称搜索当前应用可访问的多维表格
get_bitable_views 获取数据表视图

示例

在 Claude Code 中使用:

帮我列出多维表格 bascnxxxxxxxx 的所有数据表
帮我读取 bascnxxxxxxxx 表格中 tblxxxxxxxx 表的前 100 条记录
帮我搜索名称里带 “test” 的多维表格

License

MIT