Shortcut.com MCP 서버

Shortcut.com에서 티켓에 접근하고 검색하기 위한 MCP(Model Context Protocol) 서버 구현입니다.

개요

이 프로젝트는 Claude를 비롯한 MCP 호환 AI 비서가 Shortcut.com의 티켓 관리 시스템과 상호 작용할 수 있도록 하는 MCP 서버를 구현합니다. 이 통합을 통해 AI 비서는 다음과 같은 작업을 수행할 수 있습니다.

• Shortcut에서 스토리(티켓)를 나열하고 검색합니다.

• 특정 스토리에 대한 자세한 정보를 얻으세요

• 새로운 스토리를 만들어 보세요

• 기존 스토리 업데이트

• 스토리에 댓글 추가

• 워크플로 상태 및 프로젝트 검색

필수 조건

• 파이썬 3.10+

• Shortcut.com API 토큰

설치

1. 이 저장소를 복제하세요:

   지엑스피1

2. 가상 환경을 만들고 종속성을 설치합니다.

   # Using uv (recommended) curl -LsSf https://astral.sh/uv/install.sh | sh # For Mac/Linux uv venv source .venv/bin/activate # On Mac/Linux or .venv\Scripts\activate on Windows uv pip install -r requirements.txt # Using pip python -m venv venv source venv/bin/activate # On Mac/Linux or venv\Scripts\activate on Windows pip install -r requirements.txt

3. Shortcut API 토큰을 사용하여 프로젝트 루트 디렉토리에 .env 파일을 만듭니다.

   SHORTCUT_API_TOKEN=your_token_here SERVER_PORT=5000 SERVER_HOST=0.0.0.0 DEBUG_MODE=True

서버 실행

다음을 사용하여 MCP 서버를 시작합니다.

Claude Desktop 구성

Claude Desktop과 함께 이 MCP 서버를 사용하려면:

1. Claude Desktop 구성 파일을 편집합니다.

   • Mac: ~/Library/Application Support/Claude/claude_desktop_config.json

   • Windows: %APPDATA%\Claude\claude_desktop_config.json

2. MCP 서버 구성을 추가합니다.

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

3. Claude Desktop을 다시 시작합니다.

사용 가능한 MCP 기능

자원

• shortcut://stories - 스토리 목록에 액세스

• shortcut://story/{story_id} - 특정 스토리에 접근합니다

도구

• list_stories - 선택적 필터링을 사용하여 스토리 목록 작성

• search_stories - 텍스트 쿼리를 사용하여 스토리 검색

• get_story_details - 특정 스토리에 대한 자세한 정보를 가져옵니다.

• create_story - 새로운 스토리를 만듭니다

• update_story - 기존 스토리 업데이트

• add_comment - 스토리에 댓글 추가

• list_workflow_states - 모든 워크플로 상태 나열

• list_projects - 모든 프로젝트 나열

프롬프트

• create_bug_report - 버그 보고서를 위한 템플릿 생성

• create_feature_request - 기능 요청에 대한 템플릿 생성

프로젝트 구조

• src/ - 소스 코드 디렉토리

  • server.py - 주요 MCP 서버 구현

  • config.py - 구성 관리

  • shortcut_client.py - Shortcut API용 클라이언트

  • utils.py - 유틸리티 함수 및 데이터 모델

• requirements.txt - 프로젝트 종속성

• .env - 환경 변수(git에서는 추적되지 않음)

개발

새로운 기능 추가

MCP 서버에 새로운 기능을 추가하려면:

1. 새로운 API 메서드를 shortcut_client.py 에 추가합니다.

2. 필요한 경우 utils.py 에 Pydantic 모델을 정의하세요.

3. server.py 에 데코레이터를 사용하여 MCP 기능을 구현합니다.

   • 읽기 전용 리소스의 경우 @mcp.resource() 사용하세요.

   • 데이터를 수정할 수 있는 작업에는 @mcp.tool() 사용하세요.

   • 템플릿이나 구조화된 텍스트를 생성하려면 @mcp.prompt() 를 사용하세요.

기여하다

기여를 환영합니다! 풀 리퀘스트를 제출해 주세요.

특허

MIT 라이센스