base-mcp-server

这是一个提供对Feishu Base（飞书多维表格）数据库读写访问的Model Context Protocol服务器。此服务器允许LLMs检查数据库模式，然后读取和写入记录。

使用方法

1. 安装Node.js

确保您的机器上已安装Node.js。

2. 获取Base令牌

获取您的base账户的appToken和personalBaseToken。

3. 全局安装MCP服务器包

使用npm全局安装MCP服务器包：

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

4. MCP服务器配置

在您的MCP服务器配置文件中添加以下内容：

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

注意：如果您正在使用Claude，您需要通过Claude客户端设置中的开发者选项添加MCP配置。您可以在设置菜单中找到它，并在相关部分下添加MCP服务器详细信息。

令牌

在使用此MCP服务器之前，您需要获取两个令牌。

• personalBaseToken：在您的base中找到Base插件UI，然后访问自定义插件->获取授权码

• appToken：您可以通过一个开发工具插件快速获得appToken。这里是一个简化的步骤过程：

组件

工具

• list_tables

  • 列出base中的所有表
  • 不需要输入参数

• list_records

  • 列出指定表中的记录
  • 输入参数：
    • tableId (字符串，必需)：要查询的表ID

• get_record

  • 根据ID获取特定记录
  • 输入参数：
    • tableId (字符串，必需)：表ID
    • recordId (字符串，必需)：要检索的记录ID

• create_record

  • 在表中创建新记录
  • 输入参数：
    • tableId (字符串，必需)：表ID
    • fields (对象，必需)：新记录的字段和值

• update_record

  • 更新表中的记录
  • 输入参数：
    • tableId (字符串，必需)：表ID
    • recordId (字符串，必需)：记录ID
    • fields (对象，必需)：要更新的字段及其新值

• delete_record

  • 从表中删除记录
  • 输入参数：
    • tableId (字符串，必需)：表ID
    • recordId (字符串，必需)：要删除的记录ID

• create_table

  • 在base中创建新表
  • 输入参数：
    • name (字符串，必需)：新表名称
    • fields (数组，必需)：字段定义数组（名称、类型、描述、选项）

• update_table

  • 更新表的名称
  • 输入参数：
    • tableId (字符串，必需)：表ID
    • name (字符串，必需)：表的新名称

• delete_table

  • 删除表
  • 输入参数：
    • tableId (字符串，必需)：要删除的表ID

• list_fields

  • 列出表中的所有字段
  • 输入参数：
    • tableId (字符串，必需)：表ID

• create_field

  • 在表中创建新字段
  • 输入参数：
    • tableId (字符串，必需)：表ID
    • nested (对象，必需)：包含字段配置的对象，其中包含：
      • field (对象，必需)：字段定义，包括名称、类型和其他属性

• update_field

  • 更新表中的字段
  • 输入参数：
    • tableId (字符串，必需)：表ID
    • fieldId (字符串，必需)：字段ID
    • nested (对象，必需)：更新后的字段配置

• delete_field

  • 从表中删除字段
  • 输入参数：
    • tableId (字符串，必需)：表ID
    • fieldId (字符串，必需)：要删除的字段ID

开发

开始开发：

1. 安装Node.js
2. 克隆仓库
3. 使用npm install安装依赖项
4. 运行npm dev启动开发服务器
5. 运行npm test运行测试
6. 使用npm build构建项目

可用脚本：

• npm dev：以开发模式构建并运行服务器
• npm start：运行服务器
• npm test：运行测试
• npm test:watch：监视模式下运行测试
• npm lint：运行ESLint
• npm build：构建项目
• npm build:watch：监视更改并自动重新构建

项目结构

.
├── src/                # 源代码
│   ├── index.ts       # 主入口点(stdio)
│   ├── index.sse.ts   # SSE入口点
│   ├── service/       # 服务实现
│   ├── types/         # TypeScript类型定义
│   ├── utils/         # 实用函数
│   └── test/          # 测试文件
├── dist/              # 编译输出

依赖项

主要依赖项：

• @lark-base-open/node-sdk：Feishu Base Node.js SDK
• @modelcontextprotocol/sdk：Model Context Protocol SDK
• express：Web框架
• zod：模式验证

许可证

MIT