Twist MCP Server

Twist MCP 服务器（测试中）

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

安装

先决条件

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

获取 Twist API 令牌

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

未来版本将使用适当的 OAuth 身份验证。

使用 Claude Desktop 进行配置

将 Twist MCP 服务器添加到 claude_desktop_config.json 中的 MCP 服务器集合中：

可用工具

截至目前，以下工具可用：

• 收件箱
  • 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 许可证。详情请参阅许可证文件。