remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

Provides tools for interacting with Shortcut (formerly Clubhouse) to view and manage projects, stories, epics, and objectives, including capabilities for searching through stories and creating new items.

바로가기 MCP 서버

[!경고] 이것은 WIP 서버이므로 의도한 대로 작동하지 않을 수 있습니다.

Shortcut(이전 명칭 Clubhouse)과 상호작용하기 위한 MCP(Model Context Protocol) 서버입니다.

특징

프로젝트, 스토리, 서사시 및 목표 보기
스토리 검색
새로운 스토리, 서사시, 목표를 만들어보세요
안전한 작업만 가능합니다(업데이트나 삭제 불가)

설정

asdf로 Python 설치:

지엑스피1

가상 환경을 생성하고 종속성을 설치합니다.

uv venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate
uv pip install -e .  # Install package in editable mode

환경 설정:

cp .env.example .env
# Edit .env and add your Shortcut API token

서버를 실행합니다:

python -m shortcut_mcp

프로젝트 구조

shortcut-mcp/
├── src/
│   └── shortcut_mcp/      # Main package directory
│       ├── __init__.py    # Package initialization
│       ├── __main__.py    # Entry point
│       └── server.py      # Server implementation
├── pyproject.toml         # Project configuration
├── .tool-versions         # ASDF version configuration
├── .pylintrc             # Pylint configuration
└── README.md

Claude Desktop과 함께 사용

Claude Desktop 구성에 다음을 추가하세요.

MacOS( ~/Library/Application Support/Claude/claude_desktop_config.json )의 경우:

{
  "mcpServers": {
    "shortcut": {
      "command": "python",
      "args": ["-m", "shortcut_mcp"],
      "env": {
        "SHORTCUT_API_TOKEN": "your_token_here"
      }
    }
  }
}

Windows( %AppData%\Claude\claude_desktop_config.json )의 경우:

{
  "mcpServers": {
    "shortcut": {
      "command": "python",
      "args": ["-m", "shortcut_mcp"],
      "env": {
        "SHORTCUT_API_TOKEN": "your_token_here"
      }
    }
  }
}

테스트

MCP Inspector를 사용하여 서버를 테스트할 수 있습니다.

npx @modelcontextprotocol/inspector python -m shortcut_mcp

안전 기능

이 서버는 안전한 생성 기능을 갖춘 읽기 전용 작업을 구현합니다.

GET(읽기) 및 POST(생성) 작업만 허용합니다.
기존 데이터의 수정이나 삭제가 없습니다.
모든 작업은 API 토큰 소유자에게 귀속됩니다.

개발

파이썬 버전 관리

이 프로젝트에서는 Python 버전 관리를 위해 asdf를 사용합니다. 필요한 Python 버전은 .tool-versions 에 지정됩니다.

# Install Python with asdf
asdf install python

# The correct version will be automatically selected based on .tool-versions

코드 품질

코드 품질 검사를 위해 pylint를 사용합니다. 다음과 같이 실행해 보세요.

pylint src/shortcut_mcp

pylint의 구성은 .pylintrc 에 있습니다.

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested

Shortcut(이전 Clubhouse) 프로젝트 관리 도구와의 상호작용을 가능하게 하는 모델 컨텍스트 프로토콜 서버로, 사용자는 프로젝트, 스토리, 에픽, 목표를 보고 검색할 수 있으며, 자연어를 통해 새로운 항목을 만들 수 있습니다.

Related Resources

Reddit Discussion about this server

Shortcut MCP Server