바로가기 MCP 서버

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

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

특징

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

Related MCP server: Shortcut.com MCP Server

설정

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

F

license - not found

-

quality - not tested

-

maintenance - not tested

How are these scores calculated?

Resources

GitHub Repository

Need Help?

Reddit Discussion

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Shortcut MCP Server