Twist MCP 服务器（测试中）

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

安装

先决条件

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

获取 Twist API 令牌

登录您的Twist账户
访问Twist App 控制台
创建供个人使用的新应用程序
复制 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" } } } }

Related MCP server: Unstructured API MCP Server

可用工具

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

收件箱
- 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 ：取消静音线程