Smartsheet MCP Server

基本能力

产品定位

Smartsheet MCP Server 是一个中间件服务，旨在通过标准化的 MCP 协议为 AI 系统提供与 Smartsheet 表格管理系统的交互能力。

核心功能

• 获取 Smartsheet 表格的详细信息
• 创建、更新和删除表格及行数据
• 创建特定时间点的表格版本备份
• 为 AI 消费优化的格式化响应

适用场景

• 自动化表格数据管理
• 历史数据版本控制
• AI 辅助的表格操作
• 团队协作数据管理

工具列表

1. get_sheet: 检索表格当前状态(包括行、列和单元格)
2. get_sheet_version: 获取表格当前版本号
3. get_cell_history: 检索特定单元格的变更历史
4. update_rows: 更新表格中的行数据
5. add_rows: 向表格添加新行
6. delete_rows: 从表格中删除行(需环境变量允许)
7. get_sheet_location: 获取表格所在文件夹ID
8. copy_sheet: 复制指定表格
9. create_sheet: 创建新表格
10. create_version_backup: 创建特定时间点的表格备份

常见问题解答

• 需要设置 SMARTSHEET_API_KEY 环境变量才能使用
• 删除操作默认禁用，需设置 ALLOW_DELETE_TOOLS=true
• 使用 npm run dev 可同时构建和启动服务

使用教程

使用依赖

• Node.js 16 或更高版本
• npm 7 或更高版本

安装教程

1. 克隆仓库:

git clone https://github.com/smar-imran-khawaja/smar-mcp.git
cd smar-mcp

1. 安装依赖:

npm install

1. 创建.env文件并添加API密钥:

SMARTSHEET_API_KEY=your_smartsheet_api_token

1. 构建项目:

npm run build

调试方式

1. 推荐使用npm脚本启动:

npm run start

或

npm run dev

1. 直接使用Node.js运行:

node -r dotenv/config build/index.js

或

node build/index.js

成功启动后会显示: "Smartsheet MCP Server running on stdio"

许可证

该项目遵循 Apache-2.0 开源许可条款，请参阅 Apache-2.0 了解完整条款。