issue-tracker-mcp

AI 어시스턴트가 칸반 이슈 보드를 관리할 수 있게 해주는 최소한의 Model Context Protocol 서버입니다.

스트리밍 가능한 HTTP 전송 방식을 사용하므로, 동일한 코드로 로컬 개발과 전체 팀이 연결하는 호스팅 배포 환경 모두에서 작동합니다.

실습

src/server.ts에는 서버 스캐폴딩과 등록 방식의 예시를 확인할 수 있는 하나의 완성된 도구(list_issues)가 포함되어 있습니다. 나머지 4개의 도구는 TODO 주석으로 남겨져 있으며, 여러분의 과제는 server.registerTool(...)을 사용하여 이를 구현하는 것입니다:

• get_issue

• create_issue

• update_issue

• delete_issue

src/store.ts의 데이터 계층은 이미 완성되어 있으므로, 이를 연결하기만 하면 됩니다. 각 도구를 구현한 후 서버를 재시작하고 Inspector에서 테스트해 보세요.

막히셨나요? solution 브랜치에 완전히 작동하는 버전이 있습니다.

Related MCP server: kanban-lite

실행 방법

npm install
npm start
# → Issue Tracker MCP server listening on http://localhost:3001/mcp

수동 테스트

MCP Inspector는 도구를 직접 호출해 볼 수 있는 작은 웹 UI입니다:

npm run inspect
# then choose "Streamable HTTP" and enter http://localhost:3001/mcp

클라이언트 연결

팀을 위한 배포

이것은 일반적인 Express 앱입니다. npm start를 모든 Node 호스트(Render, Railway, Fly.io, Cloudflare Workers, VPS 등)에 배포하고 생성된 https://…/mcp URL을 공유하세요. 해당 URL을 추가하는 모든 사용자는 동일한 보드와 상호작용하게 됩니다.