Twist MCP Server (testing)

Twist MCP 服务（测试版）

用于与 Twist 工作区交互的 MCP 服务。使用 Python 和 Twist REST API 编写。目前仅供测试使用。

安装

前提条件

• Python 3.10+
• UV 包管理器（安装指南）
• Twist API 令牌
• Twist 工作区 ID

获取 Twist API 令牌

1. 登录 Twist 账号
2. 访问 Twist 应用控制台
3. 创建一个供个人使用的新应用
4. 复制 OAuth 2 测试令牌；此令牌将授予 MCP 服务对当前登录用户的完全范围访问权限。

未来版本将使用正规的 OAuth 身份验证。

使用 Claude Desktop 配置

将 Twist MCP 服务添加到 claude_desktop_config.json 中的 MCP 服务列表：

{
  "mcpServers": {
    "twist": {
      "command": "uv",
      "args": [
        "--directory",
        "/absolute/path/to/twist-mcp-server",
        "run",
        "main.py"
      ],
      "env": {
        "TWIST_API_TOKEN": "your_twist_api_token",
        "TWIST_WORKSPACE_ID": "your_twist_workspace_id"
      }
    }
  }
}

可用工具

目前提供以下工具：

• 收件箱
  • twist_inbox_get：获取用户收件箱的内容
  • twist_inbox_archive_all：归档工作区中的所有线程（或某个时间戳之后的所有线程）
  • twist_inbox_archive：按 ID 归档指定线程
  • twist_inbox_unarchive：按 ID 取消归档指定线程
  • twist_inbox_mark_all_read：将收件箱中的所有线程标记为已读
  • twist_inbox_get_count：获取收件箱线程数量
• 线程
  • twist_threads_getone：按 ID 获取线程
  • twist_threads_get：获取频道中的所有线程
  • twist_threads_add：向频道添加新线程
  • twist_threads_update：更新现有线程
  • twist_threads_remove：移除线程
  • twist_threads_star：为线程加星标
  • twist_threads_unstar：取消线程的星标
  • twist_threads_pin：置顶线程
  • twist_threads_unpin：取消置顶线程
  • twist_threads_move_to_channel：将线程移至其他频道
  • twist_threads_get_unread：获取工作区中的未读线程
  • twist_threads_mark_read：将线程标记为已读
  • twist_threads_mark_unread：将线程标记为未读
  • twist_threads_mark_unread_for_others：将线程标记为其他人的未读
  • twist_threads_mark_all_read：将工作区或频道中的所有线程标记为已读
  • twist_threads_clear_unread：清除工作区中的未读线程
  • twist_threads_mute：将线程静音指定分钟数
  • twist_threads_unmute：取消线程静音

许可证

本项目采用 MIT 许可证。详情请参阅 LICENSE 文件。