FogBugz MCP 서버

Claude와 같은 LLM을 통해 FogBugz와 상호 작용하기 위한 Model Context Protocol (MCP) 서버입니다. 시작 시 자동 버전 감지를 통해 XML API(/api.asp)와 JSON API(/f/api/0/jsonapi)를 모두 지원합니다. 온프레미스 및 온디맨드 FogBugz 설치 환경에서 작동합니다.

개요

LLM이 다음과 같은 FogBugz 작업을 수행할 수 있도록 합니다:

• 케이스 생성, 업데이트, 해결, 재개 및 닫기

• 특정 사용자에게 케이스 할당

• 전체 이벤트/댓글 기록과 함께 케이스 검색 및 나열

• 사용자, 카테고리, 프로젝트 및 영역 나열

• 새 프로젝트 생성

• 고급 사용 사례를 위한 일반 API 요청

API 자동 감지

시작 시 서버는 FogBugz 인스턴스에 적합한 API 클라이언트를 자동으로 선택합니다:

1. /api.xml을 프로빙하여 FogBugz 버전 번호를 읽습니다.

2. 버전이 9 이상인 경우, JSON API(/f/api/0/jsonapi)에 연결을 시도하며 성공 시 FogBugzJsonClient를 사용합니다.

3. 버전이 9 미만이거나 JSON 엔드포인트에 연결할 수 없는 경우 FogBugzXmlClient(XML API via /api.asp)로 대체합니다.

별도의 설정은 필요하지 않으며, 올바른 클라이언트가 자동으로 선택됩니다.

텍스트 형식 참고: XML API를 통해 FogBugz 8.x에 연결된 경우, 설명 및 댓글에서 일반 텍스트만 지원됩니다. HTML 및 Markdown은 그대로 저장되고 표시됩니다.

FogBugz API 토큰 얻기

MCP 서버를 FogBugz로 인증하려면 API 토큰이 필요합니다. 토큰을 얻는 방법은 두 가지가 있습니다:

1. 웹 UI를 통한 방법

Account & Settings → User Options로 이동하여 Create API Token 링크를 클릭합니다.

공식 가이드 참조: Create API Token using the FogBugz UI

2. API 요청을 통한 방법

다음 요청을 보냅니다(플레이스홀더를 본인의 값으로 대체하세요):

https://[your-fogbugz-server]/api.asp?cmd=logon&email=[your-email]&password=[your-password]

응답에 API 토큰이 포함됩니다.

공식 가이드 참조: Get an API Token using FogBugz API commands

설치

원클릭 설치 (Claude Desktop)

Releases 페이지에서 최신 .mcpb 패키지를 다운로드하여 엽니다. Claude Desktop이 자동으로 서버를 설치 및 구성하며, FogBugz URL과 API 키를 입력하라는 메시지를 표시합니다.

수동 설치

git clone https://github.com/todevelopers/fogbugz-mcp.git
cd fogbugz-mcp
npm install
npm run build

MCP 클라이언트 구성

MCP 클라이언트 구성(예: Claude Desktop claude_desktop_config.json)에 추가합니다:

{
  "mcpServers": {
    "fogbugz": {
      "command": "node",
      "args": ["/absolute/path/to/fogbugz-mcp/dist/index.js"],
      "env": {
        "FOGBUGZ_URL": "https://your-fogbugz-server.com",
        "FOGBUGZ_API_KEY": "your-api-token"
      }
    }
  }
}

또는 자격 증명을 명령줄 인수로 전달합니다:

{
  "mcpServers": {
    "fogbugz": {
      "command": "node",
      "args": [
        "/absolute/path/to/fogbugz-mcp/dist/index.js",
        "https://your-fogbugz-server.com",
        "your-api-token"
      ]
    }
  }
}

수동 실행

# With command-line arguments
node dist/index.js https://your-fogbugz-server.com your-api-token

# With environment variables
FOGBUGZ_URL=https://your-fogbugz-server.com FOGBUGZ_API_KEY=your-api-token npm start

# With a .env file
cp .env.example .env   # fill in FOGBUGZ_URL and FOGBUGZ_API_KEY
npm start

개발

npm run dev    # run via ts-node (no build needed)
npm run build  # compile TypeScript to dist/
npm test       # run all Jest tests

MCP 도구

케이스 관리

검색 및 보기

참조 데이터

고급

환경 변수

호환성

FogBugz 8.8.53(XML API)에서 테스트되었습니다. JSON API 지원은 사양에 따라 구현되었습니다. 서버는 시작 시 사용할 API를 자동으로 감지합니다.

감사의 말

이 프로젝트는 Sarasvati Akari Lara-Almeida의 원작을 기반으로 합니다. 기반을 마련해 주셔서 감사합니다.

라이선스

MIT © Tomáš Gažovič, ToDevelopers s.r.o.