项目简介: Quip MCP Server 是一个用于连接大型语言模型 (LLM) 客户端与 Quip 电子表格的 MCP 服务器实现。它允许 LLM 通过标准化的方式读取 Quip 文档中的电子表格数据，并提供工具和资源接口来访问这些数据。
主要功能:
- 通过工具接口获取 Quip 电子表格的内容，支持按名称指定工作表。
- 返回 CSV 格式的电子表格数据，并包含行数、大小、是否截断等元数据。
- 对于大型电子表格，返回的数据会进行截断，同时提供资源 URI 用于获取完整内容。
- 支持通过资源接口直接访问存储在本地的完整 CSV 数据。
- 处理 Quip API 认证和错误情况。
安装步骤:
- 推荐使用 uvx: 如果您已安装 'uv' 工具，无需单独安装服务器包，可以直接运行：
```
uvx quip-mcp-server
```
  （如果您没有 uv，可以先通过 'curl -LsSf https://astral.sh/uv/install.sh | sh' 安装）
- 使用 pip: 您也可以通过 pip 安装 'quip-mcp-server' 包：
```
pip install quip-mcp-server
```
  安装后，可以作为 Python 模块运行：
```
python -m src.server
```

设置环境变量: 在运行服务器前，需要设置 Quip API Token。可以通过环境变量或 '.env' 文件设置。

通过环境变量：

export QUIP_TOKEN=your_quip_api_token
# 可选：设置存储路径，默认为 ~/.quip-mcp-server/storage
export QUIP_STORAGE_PATH=/path/to/your/storage

通过 '.env' 文件：在服务器运行目录或项目根目录下创建 '.env' 文件，内容如下：

QUIP_TOKEN=your_quip_api_token
# 可选：设置存储路径
QUIP_STORAGE_PATH=/path/to/your/storage

MCP 客户端配置 (例如 Claude.app): 将以下 JSON 片段添加到您的 MCP 客户端配置中，替换 'your_quip_api_token' 和 '/path/to/storage' 为您的实际值。

"mcpServers": {
  "quip": {
    "command": "uvx",  // MCP 服务器的启动命令。如果使用 pip 安装，这里可能是 "python"
    "args": [
      "quip-mcp-server", // 启动命令的参数。如果使用 pip 安装，这里可能是 "-m", "src.server"
      "--storage-path", "/path/to/storage" // 指定本地存储路径，服务器将在此保存 CSV 文件
    ],
    "env": {
      "QUIP_TOKEN": "your_quip_api_token" // 通过环境变量将 Quip Token 传递给服务器进程
    }
  }
}

如果您希望资源 URI 指向本地文件路径 (例如用于本地调试或特定场景)，可以在 'args' 中添加 '--file-protocol' 参数：

"mcpServers": {
  "quip": {
    "command": "uvx",
    "args": [
      "quip-mcp-server",
      "--storage-path", "/path/to/storage",
      "--file-protocol" // 添加此参数，服务器生成的资源 URI 将使用 file:// 协议
    ],
    "env": {
      "QUIP_TOKEN": "your_quip_api_token"
    }
  }
}

基本使用方法: 配置完成后，您的 LLM 客户端应该能够发现并调用该服务器提供的工具和资源。
- 调用工具: LLM 可以通过调用 'quip_read_spreadsheet' 工具来读取 Quip 电子表格。例如，调用时提供参数 '{"threadId": "您的 Quip 文档 ID", "sheetName": "可选的工作表名称"}'。服务器将返回 CSV 内容和元数据，包括用于访问完整数据的 'resource_uri'。
- 访问资源: 如果通过工具获取的数据被截断，LLM 可以使用返回的 'resource_uri' 通过 MCP 的资源访问机制请求完整的 CSV 内容。

关键词

信息