Shortcut MCP Server

Shortcut MCP Server

site icon
2024.12.20 3
Python项目管理任务跟踪交流协作
Shortcut MCP Server 是一个用于与 Shortcut(原 Clubhouse)交互的 Model Context Protocol (MCP) 服务器。它提供了查看项目、故事、史诗和目标的功能,支持搜索故事,并能安全地创建新的故事、史诗和目标。该服务器仅支持读取和创建操作,不提供修改或删除功能,确保数据的安全性。
View on GitHub

Overview

基本能力

产品定位

Shortcut MCP Server 是一个用于与 Shortcut(项目管理工具)交互的 MCP 服务器,主要用于项目管理和任务跟踪。

核心功能

  • 查看项目、故事、史诗和目标
  • 搜索故事
  • 创建新的故事、史诗和目标
  • 仅支持安全操作(无更新或删除功能)

适用场景

  • 项目管理
  • 任务跟踪
  • 团队协作

工具列表

  • MCP Inspector:用于测试服务器的工具,可以通过命令行运行。

常见问题解答

  • 该服务器目前处于开发中(WIP),可能无法按预期工作。
  • 所有操作均归因于 API 令牌所有者,确保数据安全。

使用教程

使用依赖

  1. 安装 Python 和 asdf:
asdf install
  1. 创建虚拟环境并安装依赖:
uv venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate
uv pip install -e .  # Install package in editable mode
  1. 设置环境变量:
cp .env.example .env
# Edit .env and add your Shortcut API token

安装教程

  1. 运行服务器:
python -m shortcut_mcp
  1. 在 Claude Desktop 配置中添加服务器信息(MacOS 和 Windows 路径不同)。

调试方式

  1. 使用 MCP Inspector 测试服务器:
npx @modelcontextprotocol/inspector python -m shortcut_mcp
  1. 运行代码质量检查:
pylint src/shortcut_mcp

许可证

None