Table, Bro

@table-bro/mcp

Table, Bro 的 MCP 服务：为 Angular 提供像素级精准的 Material（M3）数据表格，以及更多功能。 将它添加到 Claude Code、Cursor 或 Codex，告诉 Agent 你需要什么表格，它就会根据一次请求安装软件包并生成表格、 设置和单元格，支持 Angular 和 Vanilla JS。该服务为 Agent 提供表格参考、表格规格检查工具和表格代码生成器，支持 mat（Angular Material）、bs（Bootstrap 5）和 nv（原生 HTML）皮肤。Agent 编写文件；服务只负责读取。

claude mcp add --scope project table-bro -- npx -y @table-bro/[email protected]

其他 Agent 的设置见下文。文档：MCP 服务、 快速入门。

工具	提供的内容
get_started	Table, Bro 的工作方式、工具的使用顺序，以及适用于目标和皮肤的最简表格，每个会话提供一次
get_docs	参考文档中的主题或文档页面及其代码、查询涉及的主题，或主题列表
inspect_project	项目的软件包、皮肤、CSS、元素和表格，以及设置问题和对应的修复方法
validate_spec	表格规格中的所有错误和警告，以及对应的路径和修复方法
generate_code	根据规格或内置规格生成新表格的文件、项目设置，以及需要手动完成的内容
scaffold_component	为现有表格添加一个自定义单元格、行详情或 Filter Drawer 的筛选器，并说明如何连接

设置

该服务会描述一个特定版本的 Table, Bro：运行项目所使用的 @table-bro/core 版本，如下方的 1.2.0。 更新 Table, Bro 后，也要更改 Agent 设置中的版本；inspect_project 会比较版本，并指出需要更改的行。

npx 会下载软件包并启动服务：项目不会安装 @table-bro/mcp。需要 Node.js 22.12 或更高版本。

Claude Code，项目根目录下的 .mcp.json：

{"mcpServers": {"table-bro": {"command": "npx", "args": ["-y", "@table-bro/[email protected]"]}}}

或者运行 claude mcp add --scope project table-bro -- npx -y @table-bro/[email protected]。

Codex，~/.codex/config.toml：

[mcp_servers.table-bro]
command = "npx"
args = ["-y", "@table-bro/[email protected]"]

当项目的 AGENTS.md 中有说明时，Codex 会调用服务的工具：

The tables of this project are Table, Bro. Its MCP server table-bro has the reference, the check of a table and the code generator: call its tool get_started before you write or change a table.

Cursor，项目中的 .cursor/mcp.json：

{"mcpServers": {"table-bro": {"command": "npx", "args": ["-y", "@table-bro/[email protected]"]}}}

VS Code，项目中的 .vscode/mcp.json：

{"servers": {"table-bro": {"type": "stdio", "command": "npx", "args": ["-y", "@table-bro/[email protected]"]}}}

Claude Desktop，claude_desktop_config.json：

{"mcpServers": {"table-bro": {"command": "npx", "args": ["-y", "@table-bro/[email protected]"]}}}

项目文件夹

inspect_project 会以文本形式读取项目。它使用参数 path 指定的文件夹；如果未指定，则使用客户端提供的第一个工作区根目录，否则使用客户端启动服务时所在的文件夹。若客户端在项目外启动服务且没有提供根目录（例如桌面应用可能会这样），则需要指定 path：由 Agent 传入项目根目录。配置文件会标明其描述的文件夹。

付费模块

启动服务时指定 Table, Bro 的付费模块名称，且项目中已安装该模块后，该模块的配置字段、主题和设置才会添加到服务中：

{"mcpServers": {"table-bro": {"command": "npx", "args": ["-y", "@table-bro/[email protected]", "--extension", "<the package of the module>"]}}}

该服务不会运行任何其他软件包的代码。

代码中

这些工具都是纯函数，软件包会面向 Node.js 和浏览器导出它们：validateSpec、 generateCode、getDocs、内置规格 builtinSpecs，以及规格的 JSON Schema specSchema。

许可证

MIT