Smartsheet MCP Server

<!-- 覆盖范围和状态徽章 -->

<!-- 结束覆盖范围和状态徽章 -->

这是一个提供与 Smartsheet 无缝集成的 Model Context Protocol (MCP) 服务器，通过标准化接口实现对 Smartsheet 文档的自动化操作。该服务器弥合了 AI 驱动的自动化工具与 Smartsheet 强大的协作平台之间的差距。

概述

Smartsheet MCP 服务器旨在促进与 Smartsheet 的智能交互，提供了一套强大的工具用于文档管理、数据操作和列定制。它作为自动化工作流中的关键组件，使 AI 系统能够以编程方式与 Smartsheet 数据进行交互，同时维护数据完整性并执行业务规则。

主要优势

• 智能集成：无缝连接 AI 系统与 Smartsheet 协作平台
• 数据完整性：执行验证规则并跨操作维护引用完整性
• 公式管理：自动保存和更新公式引用
• 灵活配置：支持各种列类型和复杂的数据结构
• 错误恢复能力：在多层中实现全面的错误处理和验证
• 医疗分析：针对临床和研究数据的专业分析能力
• 批处理：高效处理大型医疗数据集
• 自定义评分：适用于医疗计划和研究的灵活评分系统

使用场景

1. 临床研究分析

   • 协议合规性评分
   • 患者数据分析
   • 研究影响评估
   • 临床试验数据处理
   • 自动化研究笔记总结

2. 医院运营

   • 资源利用率分析
   • 患者满意度评分
   • 部门效率指标
   • 员工绩效分析
   • 质量指标跟踪

3. 医疗创新

   • 儿科对齐评分
   • 创新影响评估
   • 研究优先级排序
   • 实施可行性分析
   • 临床价值评估

4. 自动化文档管理

   • 程序化表结构修改
   • 动态列创建和管理
   • 自动数据验证和格式化

5. 数据操作

   • 完整性检查下的批量数据更新
   • 智能重复检测
   • 公式感知的修改

6. 系统集成

   • AI 驱动的表定制
   • 自动化的报告工作流程
   • 跨系统的数据同步

集成点

服务器集成：

• 通过 Smartsheet API 进行数据操作
• 通过 MCP 协议进行标准化通信
• 通过 stdio 接口与本地开发工具集成
• 通过结构化日志与监控系统集成

功能

工具（34个可用）

1. get_column_map（读取）

   • 从 Smartsheet 中检索列映射和示例数据
   • 提供详细的列元数据，包括：
     • 列类型（系统列、公式、下拉列表）
     • 验证规则
     • 格式规范
     • 自动编号配置
   • 返回上下文示例数据
   • 包括写入数据的使用示例

2. get_sheet_info（读取 - 别名）

   • get_column_map 的别名，提供相同的功能
   • 维持与现有集成的向后兼容性

3. smartsheet_write（创建）

   • 将新行写入 Smartsheet，并智能处理：
     • 系统管理的列
     • 多选下拉列表值
     • 基于公式的列
   • 实现自动重复检测
   • 在现有条目之后追加新行到表底部
   • 返回详细的操作结果，包括行 ID

4. smartsheet_update（更新）

   • 更新 Smartsheet 中的现有行
   • 支持部分更新（修改特定字段）
   • 通过验证维护数据完整性
   • 一致地处理多选字段
   • 返回每行的成功/失败详情

5. smartsheet_delete（删除）

   • 从 Smartsheet 中删除行
   • 支持多个行的批量删除
   • 验证行存在性和权限
   • 返回详细的操作结果

6. smartsheet_search（搜索）

   • 在表之间执行高级搜索
   • 支持多种搜索模式：
     • 支持正则表达式的文本搜索
     • 下拉列表列的确切值匹配
     • 大小写敏感和整个单词选项
   • 列特定搜索能力
   • 返回：
     • 匹配行的 ID（主要结果）
     • 详细的匹配信息
     • 搜索元数据和统计信息

7. smartsheet_add_column（列管理）

   • 向 Smartsheet 添加新列
   • 支持所有列类型：
     • TEXT_NUMBER
     • DATE
     • CHECKBOX
     • PICKLIST
     • CONTACT_LIST
   • 可配置选项：
     • 位置索引
     • 验证规则
     • 公式定义
     • 下拉列表选项
   • 通过验证强制执行列限制（400）
   • 返回详细的列信息

8. smartsheet_delete_column（列管理）

   • 安全删除带有依赖关系检查的列
   • 删除前验证公式引用
   • 防止删除在公式中使用的列
   • 返回详细的依赖信息
   • 支持强制删除选项

9. smartsheet_rename_column（列管理）

   • 重命名列同时保留关系
   • 自动更新公式引用
   • 维护数据完整性
   • 验证名称唯一性
   • 返回详细的更新信息

10. smartsheet_bulk_update（条件更新）

    • 根据规则执行条件批量更新
    • 支持复杂的条件评估：
      • 多个运算符（等于、包含、大于等）
      • 类型特定的比较（文本、日期、数字）
      • 空/非空检查
    • 可配置大小的批处理
    • 全面的错误处理和回滚
    • 跟踪详细的操作结果

11. get_all_row_ids（实用工具）

    • 从 Smartsheet 中检索所有行 ID
    • 对于批处理操作和数据分析很有用
    • 返回完整的行标识符列表
    • 高效支持大型表

12. start_batch_analysis（医疗分析）

    • 使用 AI 分析处理整个表或选定的行
    • 支持多种分析类型：
      • 临床笔记总结
      • 患者反馈情感分析
      • 医疗计划的自定义评分
      • 研究影响评估
    • 特点：
      • 自动批处理（每批 3 行以优化性能）
      • 进度跟踪和状态监控
      • 错误处理和详细报告
      • 通过 Azure OpenAI 可定制分析目标
      • 支持多个源列
      • 大文本内容的令牌感知分块

13. get_job_status（分析监控）

    • 跟踪批处理分析进度
    • 提供详细的作业统计信息：
      • 待处理的总行数
      • 已处理的行数
      • 失败的行数
      • 处理时间戳
    • 实时状态更新
    • 全面的错误报告

14. cancel_batch_analysis（作业控制）

    • 取消正在运行的批处理分析作业
    • 平稳终止进程
    • 维护数据一致性
    • 返回最终作业状态

15. list_workspaces（工作区管理）

    • 列出所有可访问的工作区
    • 返回工作区 ID、名称和永久链接
    • 包含访问级别信息
    • 支持组织范围的工作区发现

16. get_workspace（工作区管理）

    • 获取详细的工作区信息
    • 返回包含的表、文件夹、报告和仪表板
    • 提供访问级别和权限详情
    • 支持工作区内容探索

17. create_workspace（工作区管理）

    • 创建具有指定名称的新工作区
    • 返回新的工作区 ID 和确认
    • 使程序化工作区组织成为可能
    • 支持从已弃用的文件夹端点迁移

18. create_sheet_in_workspace（工作区管理）

    • 直接在工作区内创建新表
    • 支持所有列类型和配置
    • 返回新表 ID 和详细信息
    • 使程序化表创建和组织成为可能

19. list_workspace_sheets（工作区管理）

    • 列出特定工作区内的所有表
    • 返回表 ID、名称和永久链接
    • 包含创建和修改的时间戳
    • 支持工作区内容发现

20. smartsheet_upload_attachment（附件管理）

    • 将文件上传到表、行或评论
    • 支持多种附件类型和文件大小验证
    • 返回附件元数据和上传状态

21. smartsheet_get_attachments（附件管理）

    • 列出表或行的所有附件
    • 返回全面的附件元数据
    • 包含文件 URL、大小和创建者信息

22. smartsheet_download_attachment（附件管理）

    • 将特定附件下载到本地文件系统
    • 根据需要创建目录并验证下载
    • 返回下载状态和文件信息

23. smartsheet_delete_attachment（附件管理）

    • 从表中移除附件
    • 验证权限并返回删除状态

24. smartsheet_create_discussion（讨论管理）

    • 在表或行上创建新的讨论线程
    • 支持初始评论和可选标题
    • 返回讨论元数据和创建状态

25. smartsheet_add_comment（讨论管理）

    • 向现有讨论添加评论
    • 维护线程对话结构
    • 返回评论详情和时间戳

26. smartsheet_get_discussions（讨论管理）

    • 列出表或行的所有讨论
    • 可选地在响应中包含所有评论
    • 返回讨论元数据和参与者信息

27. smartsheet_get_comments（讨论管理）

    • 获取特定讨论线程中的所有评论
    • 如果存在，包含附件信息
    • 返回按时间顺序排列的评论历史

28. smartsheet_delete_comment（讨论管理）

    • 从讨论中删除特定评论
    • 删除前验证权限
    • 返回删除确认

29. smartsheet_get_cell_history（单元格历史记录及审计）

    • 获取单个单元格的修改历史
    • 包含用户归属和时间戳
    • 跟踪值变化、公式和格式

30. smartsheet_get_row_history（单元格历史记录及审计）

    • 获取整个行的更改历史
    • 提供所有单元格更改的时间轴
    • 支持特定列过滤和完整的审计轨迹

31. smartsheet_get_sheet_cross_references（跨表引用）

    • 分析表内所有跨表引用
    • 识别引用其他表的公式
    • 详细分析公式模式和依赖关系

32. smartsheet_find_sheet_references（跨表引用）

    • 查找引用特定目标表的所有表
    • 在工作区或整个可访问表中搜索
    • 全面的引用映射和影响分析

33. smartsheet_validate_cross_references（跨表引用）

    • 验证所有跨表引用是否有断链
    • 识别无法访问或已删除的引用表
    • 建议替代表以修复断链

34. smartsheet_create_cross_reference（跨表引用）

    • 创建 INDEX_MATCH、VLOOKUP、SUMIF、COUNTIF 公式
    • 编程构建跨表引用公式
    • 支持自定义公式模板和多种公式类型

资源（4个静态资源 + 5个动态模板）

服务器提供了静态资源和动态资源模板，以增强数据访问和上下文信息。

静态资源

1. smartsheet://templates/project-plan - 项目计划模板

   • 预建的最佳实践项目计划模板
   • 包含任务管理的最佳列结构
   • 提供关于依赖关系和资源分配的指导

2. smartsheet://templates/task-tracker - 任务追踪器模板

   • 团队协作的简单任务追踪器模板
   • 专注于进度监控而没有复杂的依赖关系
   • 适合敏捷团队和简单的流程

3. smartsheet://schemas/column-types - 列类型参考

   • 所有支持的 Smartsheet 列类型的完整参考
   • 包含每种类型的 API 支持级别（完整、有限、只读）
   • 了解列功能和限制的关键

4. smartsheet://best-practices/formulas - 公式最佳实践

   • 常见公式模式和计算示例
   • 性能和可维护性的最佳实践
   • 跨表引用指南

动态资源模板

1. smartsheet://{sheet_id}/summary - 表摘要

   • 自动生成的摘要，包含关键指标和健康状况
   • 进度指示器和完成统计信息
   • 表数据的实时分析

2. smartsheet://{sheet_id}/gantt-data - 甘特图数据

   • 标准化的甘特图数据格式，用于可视化
   • 优化项目管理工具的时间线数据
   • 任务关系和关键路径信息

3. smartsheet://{workspace_id}/overview - 工作区概览

   • 工作区内容的综合概述
   • 所有表、报告和仪表板的结构化格式
   • 访问级别和组织层次结构

4. smartsheet://{sheet_id}/dependencies - 依赖关系图

   • 项目表的视觉依赖关系图
   • 任务关系和关键路径分析
   • 瓶颈识别和优化建议

5. smartsheet://{sheet_id}/health-report - 表健康报告

   • 识别数据质量问题的健康分析
   • 缺失数据检测和损坏公式的识别
   • 优化机会和建议

提示（6个可用）

智能提示模板，为常见的 Smartsheet 操作和分析提供引导协助。

1. create_project_plan - 项目计划创建指南

   • 引导项目计划创建，遵循最佳实践
   • 根据项目类型和持续时间建议模板
   • 工作分解结构推荐

2. analyze_project_status - 项目健康分析

   • 全面的项目健康分析，附带建议
   • 时间线遵守和资源利用洞察
   • 风险识别和缓解策略

3. optimize_workflow - 工作流优化

   • 提供建议以改进表结构和工作流
   • 自动化机会和效率提升
   • 用户体验增强建议

4. generate_insights - 数据洞察提取

   • 从表数据中提取关键洞察和模式
   • 趋势分析和异常检测
   • 可操作的情报和支持决策

5. create_dashboard_summary - 高管仪表板创建

   • 从多个表生成高管摘要
   • 高级 KPI 跟踪和战略洞察
   • 领导力聚焦的报告和建议

6. setup_conditional_formatting - 条件格式设置指南

   • 步骤说明条件格式设置
   • 视觉数据表示的最佳实践
   • 状态指示器和进度跟踪配置

关键能力

• 列类型管理

  • 处理系统列类型（如 AUTO_NUMBER、CREATED_DATE 等）
  • 支持公式解析和依赖关系跟踪
  • 管理下拉列表选项和多选值
  • 全面的列操作（添加、删除、重命名）
  • 保存和更新公式引用

• 数据验证

  • 自动重复检测
  • 列类型验证
  • 数据格式验证
  • 列依赖关系分析
  • 名称唯一性验证

• 搜索功能

  • 高级搜索能力
  • 类型感知搜索：
    • 下拉列表值的确切匹配
    • 文本字段的模式匹配
    • 数字比较
  • 可配置搜索选项：
    • 大小写敏感
    • 整词匹配
    • 列过滤
  • 全面的结果：
    • 匹配行的行 ID
    • 详细的匹配上下文