Twist MCP服务器

Twist MCP服务器（测试）

MCP服务器，用于与 扭转 工作空间。使用Python编写 扭曲REST API。目前仅用于测试目的。

安装

先决条件

• Python 3.10+
• UV包管理器(安装指南)
• 扭曲API令牌
• 扭曲工作区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许可证获得许可。请参阅 许可证 文件以获取详细信息。