MCP Smartsheet

智能表MCP服务器

模型上下文协议（MCP）服务器，用于与Smartsheet API集成。该服务器允许AI助手通过标准化的界面与Smartsheet数据进行交互。

特性

• 列出可用图纸：查看所有可访问的Smartsheet电子表格
• 读取工作表数据：访问特定表格的内容
• 增加行：向电子表格添加新行
• 更新行：更新现有行数据
• 列出列：获取工作表的列信息
• 搜索：在所有工作表中搜索特定文本

先决条件

• Node.js（v16或更高版本）
• npm或纱线
• Smartsheet API令牌（从Smartsheet UI生成）

安装

1. 克隆此存储库：

   git clone https://github.com/yourusername/smartsheet-mcp-server.git
   cd smartsheet-mcp-server

1. 安装依赖项：

   npm install

1. 构建项目：

   npm run build

用法

运行服务器

SMARTSHEET_API_TOKEN=your_api_token npm start

MCP配置

MCP配置示例见 example-mcp-config.json:

{
  "mcpServers": {
    "smartsheet": {
      "command": "node",
      "args": ["./dist/index.js"],
      "env": {
        "SMARTSHEET_API_TOKEN": "YOUR_API_KEY_HERE"
      }
    }
  }
}

此配置可用于任何兼容MCP的客户端。

用Claude运行服务器

Claude的示例配置文件提供在 example-claude-config.json:

{
  "mcpServers": {
    "smartsheet": {
      "command": "node",
      "args": ["/path/to/mcp-smartsheet/dist/index.js"],
      "env": {
        "SMARTSHEET_API_TOKEN": "YOUR_SMARTSHEET_API_TOKEN"
      }
    }
  }
}

1. 复制 example-claude-config.json 前往您选择的地点
2. 替换 /path/to/mcp-smartsheet 安装的实际路径
3. 替换 YOUR_SMARTSHEET_API_TOKEN 使用您的实际Smartsheet API令牌
4. 配置Claude以使用此配置文件

如何获取Smartsheet API代币

1. 登录您的Smartsheet帐户
2. 前往账户>个人设置>API访问
3. 点击“生成新的访问令牌”
4. 复制令牌（您将无法再次看到它）

可用工具

服务器为AI助手提供以下工具：

• listSheets：获取所有可用工作表的列表
• getSheet：获取工作表的完整内容，包括行和单元格
• addRow：在工作表中添加新行
• updateRow：更新工作表中的现有行
• list列：获取工作表的列定义
• 搜索表：在工作表中搜索特定文本

安全考虑

• 永远不要将Smartsheet API令牌提交到存储库
• 使用环境变量或安全配置服务来管理API令牌
• 考虑在Smartsheet帐户上设置适当的访问控制
• 服务器在您的计算机上本地运行

贡献

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

许可证

此项目根据MIT许可证获得许可-有关详细信息，请参阅许可证文件。