AI导哈

数据库AI连接服务

Teable MCP Server是一个连接Teable无代码数据库与大型语言模型（如Claude、ChatGPT等）的协议服务器，使AI代理能够通过自然语言查询记录、探索模式结构并检索数据。

  • by ltphat2204
  • TypeScript
  • 本地部署
  • 12 星标
  • 更新于
在 GitHub 查看 ltphat2204/teable-mcp-server

使用说明

妙趣横生的MCP服务器

A. 模型上下文协议（MCP） 连接的服务器 蒂布尔 --超快速、开源、无代码的数据库——适用于LLM等 克劳德, ChatGPT以及其他。

该服务器使AI代理能够无缝查询记录，探索模式结构（空间、基、表、视图），并使用自然语言从Teable实例中检索数据。它充当桥梁，使您的AI能够动态、智能地与您的数据交互。

🌟 什么是Teable？

蒂布尔 是基于Postgres构建的下一代开源无代码数据库。它结合了电子表格的易用性和关系数据库的强大功能。

  • 超高速：轻松处理数百万行。
  • 开源：你拥有自己的数据。自助式。
  • 类似SQL：强大的查询功能。
  • 实时：内置协作功能。
  • API第一个：专为开发人员和自动化而设计。

✨ 特性

此MCP服务器公开 27工具 LLMs，分为以下几类：

🔍 读取/查询

  • query_teable：从表中查询记录，支持过滤、排序、限制和查看范围的结果。
  • get_record：按ID检索单个记录。
  • create_record：在具有指定字段值的表中创建新记录。
  • update_record：使用指定的字段值按ID更新现有记录。
  • delete_record：永久删除记录（所有数据都将丢失）。此操作是不可逆的。
  • get_record_history：访问记录的完整更改历史记录。
  • list_spaces：列出用户可访问的所有空间。
  • list_bases：列出特定空间内的所有碱基。
  • list_tables：列出特定库中的所有表。
  • list_views：列出表中的所有视图。
  • get_table_fields：获取表的完整架构（字段定义）。

💬 记录评论

  • get_record_comments：检索特定记录上的所有评论。
  • comment_on_record：在记录上发布新评论。

🏗 现场管理

  • create_field：向表中添加新字段（支持所有字段类型：单线文本、数字、复选框、日期、单选、多选、长文本、公式、评级、货币、百分比、电子邮件、网址、电话号码、附件）。
  • update_field：重命名字段或更新其描述/选项。
  • delete_field：从表中永久删除字段及其所有数据。

📊 依赖性和影响分析

  • get_field_dependency_graph：检索表中字段的完整本地和跨表依赖关系图，使用动态Mermaid流程图可视化解析公式引用和汇总。
  • analyze_field_impact：递归分析修改或删除特定字段的上游和下游安全影响，进行全基地扫描，用可操作的安全建议清单追踪本地和外国家属。

📋 表格管理

  • create_table：在基中创建一个新表，可以选择使用初始字段。
  • update_table：重命名表或更新其描述。
  • delete_table：将桌子移到垃圾桶（可回收）。
  • export_table_data：将所有表数据导出为CSV。

🗑 桌面垃圾桶

  • get_table_trash：列出当前在回收站中的所有表。
  • restore_table_from_trash：将被丢弃的桌子恢复到活动基座。
  • permanently_delete_table：不可逆地删除表。无法撤消。

👁 视图管理

  • create_view：创建新视图（网格、图库、看板、日历、甘特图或表单）。
  • update_view：重命名视图或更新其筛选器/排序配置。
  • delete_view：从表中删除视图。
  • share_view：启用或禁用视图的公共共享链接。

🛠 配置

要使用此服务器，您需要 可撕裂的API密钥.

  1. 获取API密钥:

    • 登录您的Teable帐户并导航到 个人访问令牌设置.
    • 点击 创建新令牌.
    • 启用以下权限范围：
      • 阅读: space, base, table, record, view, field
      • 写入/修改: record （评论）， field, table, view
    • 选择合适的基础 您希望MCP服务器访问。
    • 保存令牌-您需要此令牌进行配置。

  2. 环境变量: 您可以使用特定的环境变量配置服务器。

变量 描述 必填 默认
TEABLE_API_KEY 您的个人访问令牌 是 -
TEABLE_BASE_URL API端点（如果自托管则更改） 是 https://app.teable.ai/api

🚀 用法

注： 为了 选项1 和 选项2，因为我们使用的是本地源代码，所以您必须先构建项目。

npm install && npm run build

选项1：与Claude Desktop一起使用（推荐）

将以下配置添加到您的 claude_desktop_config.json:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • 视窗: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "teable": {
      "command": "node",
      "args": [
        "/absolute/path/to/teable-mcp-server/dist/index.js"
      ],
      "env": {
        "TEABLE_API_KEY": "mcp_sk_xxxxxxxxxxxxxx",
        "TEABLE_BASE_URL": "https://app.teable.ai/api"
      }
    }
  }
}

注：更换 mcp_sk_xxxxxxxxxxxxxx 使用您的实际API密钥。

选项2：使用光标

  1. 打开 光标设置.
  2. 导航至 特性 -> 主控程序.
  3. 点击 +添加新的MCP服务器.
  4. 输入名称（例如“Teable”）。
  5. 选择 类型: command.
  6. 命令:
    node /absolute/path/to/teable-mcp-server/dist/index.js
  7. 在env部分添加环境变量：
    • TEABLE_API_KEY: your_api_key
    • TEABLE_BASE_URL: https://app.teable.ai/api

💻 本地开发

  1. 克隆存储库:

    git clone https://github.com/ltphat2204/teable-mcp-server.git
cd teable-mcp-server

  2. 安装依赖项:

    npm install

  3. 构建项目:

    npm run build

  4. 使用MCP检查器进行调试:

    export TEABLE_API_KEY=your_api_key
export TEABLE_BASE_URL=https://app.teable.ai/api
npm run inspector

🤝 贡献

欢迎投稿！请随时提交拉取请求。

  1. 分叉项目
  2. 创建功能分支(git checkout -b feature/AmazingFeature)
  3. 提交您的更改(git commit -m 'Add some AmazingFeature')
  4. 推到分支机构(git push origin feature/AmazingFeature)
  5. 打开拉取请求

📄 许可证

该项目根据MIT许可证获得许可。

相关 MCP