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 配置

在您的 claude_desktop_config.json 文件中添加 Twist MCP 服务器到 MCP 服务器集合：

json
{
"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 文件。