Lark Bitable MCP

Lark比特MCP服务器

专注MCP服务器提供 仅 通过Claude Code进行Lark Bitable（Base）操作。

🎯 特性

15个基本的比特工具：

应用程序管理（3个工具）

• bitable_create_app -创建新的Bitable应用程序
• bitable_get_app -获取应用程序详细信息
• bitable_list_apps -列出所有可访问的应用程序

表操作（4个工具）

• bitable_create_table -创建新表
• bitable_list_tables -在应用程序中列出表格
• bitable_get_table -获取表格详细信息
• bitable_delete_table -删除表格

现场管理（3个工具）

• bitable_list_fields -列表表字段
• bitable_create_field -创建新字段
• bitable_update_field -更新字段属性

记录操作（5个工具）

• bitable_create_record -创建单个记录
• bitable_batch_create_records -最多创建500条记录
• bitable_search_records -搜索/筛选记录
• bitable_update_record -更新单个记录
• bitable_batch_update_records -更新多达500条记录

🚀 快速开始

手动安装（克劳德代码）

对于希望在将此MCP服务器发布到注册表之前使用它的Claude Code用户：

1. 打开您的Claude Code MCP配置文件：

   # On macOS/Linux
   open ~/Library/Application\ Support/Claude/claude_desktop_config.json

   # Or edit directly
   nano ~/Library/Application\ Support/Claude/claude_desktop_config.json

1. 添加服务器配置：

   {
     "mcpServers": {
       "lark-bitable": {
         "url": "https://lark-bitable-mcp.hypelive.workers.dev/mcp",
         "transport": {
           "type": "http"
         },
         "headers": {
           "Authorization": "Bearer YOUR_AUTH_TOKEN_HERE"
         }
       }
     }
   }

1. 获取您的身份验证令牌：

请联系服务器管理员以获取 MCP_AUTH_SECRET 令牌。

1. 重新启动Claude代码 加载新配置。

1. 验证安装：

   # In Claude Code, ask:
   "List available MCP tools"

   # You should see 15 Bitable tools available

替代方案：使用MCP检查器进行测试：

# Install MCP Inspector
npm install -g @modelcontextprotocol/inspector

# Test the server
mcp-inspector https://lark-bitable-mcp.hypelive.workers.dev/mcp \
  --header "Authorization: Bearer YOUR_AUTH_TOKEN_HERE"

安装（自托管）

cd INFRASTRUCTURE/cloudflare/cloudflare-workers/production/lark-bitable-mcp
npm install

配置

选项1:Cloudflare Workers（远程-推荐）

部署到Cloudflare Workers：

npm run cf:deploy

设置身份验证密钥：

echo "your-secret-token" | wrangler secret put MCP_AUTH_SECRET

健康检查：

curl https://lark-bitable-mcp.hypelive.workers.dev/health

预期响应：

{
  "status": "healthy",
  "server": "lark-bitable-mcp",
  "version": "1.0.0",
  "transports": ["sse", "streamable-http"],
  "tools": 15,
  "gateway": "https://larksuite-hype-server.hypelive.workers.dev",
  "authentication": "enabled"
}

测试MCP协议：

# Get authentication token
TOKEN="your-secret-token"

# Test initialize
curl -X POST https://lark-bitable-mcp.hypelive.workers.dev/mcp \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{}}'

# List available tools
curl -X POST https://lark-bitable-mcp.hypelive.workers.dev/mcp \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'

# Call a tool (example: list apps)
curl -X POST https://lark-bitable-mcp.hypelive.workers.dev/mcp \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"bitable_list_apps","arguments":{}}}'

选项2:stdio模式（本地）

添加到Claude Code的MCP设置(~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "lark-bitable": {
      "command": "node",
      "args": [
        "/absolute/path/to/lark-bitable-mcp/src/index.ts"
      ]
    }
  }
}

选项2:HTTP/SSE模式（远程流式传输）

启动服务器：

MCP_TRANSPORT=sse PORT=3000 npm start

添加到Claude Code的MCP设置中：

{
  "mcpServers": {
    "lark-bitable-remote": {
      "command": "node",
      "args": [
        "/absolute/path/to/lark-bitable-mcp/src/index.ts"
      ],
      "env": {
        "MCP_TRANSPORT": "sse",
        "PORT": "3000"
      }
    }
  }
}

或远程连接：

{
  "mcpServers": {
    "lark-bitable-remote": {
      "url": "http://your-server:3000/sse"
    }
  }
}

验证安装

# stdio mode
claude mcp list

# HTTP mode - check health
curl http://localhost:3000/health

# HTTP mode - test SSE connection
curl -N http://localhost:3000/sse

您应该看到：

lark-bitable: 15 tools

📖 使用示例

创建应用程序和表格

// Create new Bitable app
bitable_create_app({
  name: "Project Tracker",
  folder_token: "fldXXX..." // optional
})

// Create table
bitable_create_table({
  app_token: "bascnXXX...",
  table_name: "Tasks",
  fields: [
    { field_name: "Task Name", type: 1 },
    { field_name: "Status", type: 3 },
    { field_name: "Due Date", type: 5 }
  ]
})

记录操作

// Create single record
bitable_create_record({
  app_token: "bascnXXX...",
  table_id: "tblXXX...",
  fields: {
    "Task Name": "Fix bug",
    "Status": "In Progress",
    "Due Date": 1735689600000
  }
})

// Search records with filters
bitable_search_records({
  app_token: "bascnXXX...",
  table_id: "tblXXX...",
  filter: {
    conjunction: "and",
    conditions: [
      {
        field_name: "Status",
        operator: "is",
        value: ["In Progress"]
      }
    ]
  },
  page_size: 100
})

// Batch update
bitable_batch_update_records({
  app_token: "bascnXXX...",
  table_id: "tblXXX...",
  records: [
    {
      record_id: "recXXX...",
      fields: { "Status": "Done" }
    }
  ]
})

🏗️ 建筑

User Request
    ↓
Claude Code (MCP Client)
    ↓
lark-bitable-mcp (This Server)
    ↓
larksuite-hype-server.hypelive.workers.dev (Gateway)
    ↓
Lark Open Platform API

🔧 网关端点

所有工具都通过以下方式代理： https://larksuite-hype-server.hypelive.workers.dev

映射示例：

• bitable_create_app → POST /bitable/apps
• bitable_search_records → POST /bitable/:app_token/:table_id/records/search
• bitable_list_fields → GET /bitable/:app_token/:table_id/fields

📊 字段类型参考

🆚 比较

lark bitable mcp（此服务器）

• ✅ 15个专注的Bitable工具
• ✅ 快速初始化
• ✅ 明确目的
• ✅ 易于理解
• ✅ 与Cloudflare Workers合作
• ✅ 可流式HTTP传输（JSON-RPC 2.0）

宽松的mcp包装（旧）

• ❌ 65+混合工具
• ❌ 初始化速度较慢
• ❌ 多种功能混合
• ❌ 更难导航

⚠️ 已知限制

Cloudflare Workers上不提供SSE传输

服务器发送事件（SSE）传输(/sse 由于平台限制，当部署到Cloudflare Workers时，端点）目前无法正常工作。

推荐方法：

• 使用 可流式HTTP传输 (/mcp 端点）功能齐全且经过测试
• 这 /mcp 端点支持标准JSON-RPC 2.0协议
• 所有15个Bitable工具都可以通过 /mcp 端点

对于当地发展：

• stdio模式非常适合使用Claude Code进行本地开发
• stdio模式不需要HTTP服务器

SSE状态：

• 这 /sse 端点存在于代码中，但返回Cloudflare错误1101
• 这是Cloudflare Workers环境中MCP SDK的SSEServerTransport的已知限制
• Streamable HTTP传输是推荐的生产解决方案

🐛 故障排除

“未知工具”错误

工具名称可能错误。列出可用工具：

# In Claude Code
list available MCP tools

网关超时

Lark网关可能很慢。检查状态：

curl https://larksuite-hype-server.hypelive.workers.dev/health

身份验证错误

验证您的网关是否具有有效的Lark凭据：

curl https://larksuite-hype-server.hypelive.workers.dev/bitable/apps

📝 发展

添加新工具

1. 在中添加工具定义 tools 数组
2. 在中添加端点映射 toolEndpointMap
3. 更新README.md
4. 使用Claude代码进行测试

本地测试

npm run dev
# In another terminal:
echo '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | node src/index.ts

🔗 相关

• Lark开放平台文档
• MCP协议规范
• 网关服务器

📄 许可证

麻省理工学院