바로가기 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.mdClaude 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_mcppylint의 구성은 .pylintrc 에 있습니다.