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"
}
}
}
}
可用工具
截至目前,以下工具可用:
- 收件箱
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 许可证。详情请参阅许可证文件。