JIRA MCP 서버

표준화된 도구와 컨텍스트를 통해 대규모 언어 모델(LLM)이 JIRA와 상호 작용할 수 있도록 하는 MCP 서버입니다. 이 서버는 JQL을 사용하여 이슈를 검색하고 자세한 이슈 정보를 가져오는 기능을 제공합니다.

특징

• JQL 검색 : 페이지네이션 지원을 통해 복잡한 JQL 쿼리 실행

• 이슈 세부 정보 : 특정 JIRA 이슈에 대한 자세한 정보를 검색합니다.

Related MCP server: Python Jira MCP Server

필수 조건

• npm 설치됨

• API 액세스가 가능한 JIRA 인스턴스

• JIRA API 토큰 또는 개인 액세스 토큰

• API 토큰과 연결된 JIRA 사용자 이메일

JIRA API 자격 증명 얻기

1. https://id.atlassian.com 에서 Atlassian 계정에 로그인하세요.

2. 보안 설정으로 이동

3. API 토큰에서 "API 토큰 만들기"를 선택하세요.

4. 토큰에 의미 있는 이름을 지정하세요(예: "MCP 서버")

5. 생성된 토큰을 복사하세요. 다시 볼 수 없게 됩니다!

6. 이 토큰을 JIRA_API_KEY 로 사용하세요

7. Atlassian 계정과 연결된 이메일 주소를 JIRA_USER_EMAIL 로 사용하세요.

용법

Claude Desktop과 통합

1. Claude Desktop의 구성 파일에 서버 구성을 추가합니다.

macOS : ~/Library/Application Support/Claude/claude_desktop_config.json Windows : %APPDATA%\Claude\claude_desktop_config.json

지엑스피1

2. 새로운 구성을 로드하려면 Claude Desktop을 다시 시작하세요.

사용 가능한 도구

1. JQL 검색( jql_search )

사용자 정의 가능한 매개변수를 사용하여 JQL 검색 쿼리를 실행합니다.

매개변수 :

• jql (필수): JQL 쿼리 문자열

• nextPageToken : 페이지 매김을 위한 토큰

• maxResults : 반환할 최대 결과 수

• fields : 포함할 필드 이름 배열

• expand : 포함할 추가 정보

예 :

{
  "jql": "project = 'MyProject' AND status = 'In Progress'",
  "maxResults": 10,
  "fields": ["summary", "status", "assignee"]
}

2. 이슈 가져오기( get_issue )

특정 문제에 대한 자세한 정보를 검색합니다.

매개변수 :

• issueIdOrKey (필수): 발급 ID 또는 키

• fields : 포함할 필드 이름 배열

• expand : 포함할 추가 정보

• properties : 포함할 속성 배열

• failFast : 오류 발생 시 빠르게 실패할지 여부

예 :

{
  "issueIdOrKey": "PROJ-123",
  "fields": ["summary", "description", "status"],
  "expand": "renderedFields,names"
}

개발

구성

서버를 실행하기 전에 환경 변수를 설정하세요. 루트 디렉터리에 .env 파일을 만드세요.

JIRA_INSTANCE_URL=https://your-instance.atlassian.net
JIRA_USER_EMAIL=your-email@company.com
JIRA_API_KEY=your-api-token

값을 다음으로 바꾸세요:

• 실제 JIRA 인스턴스 URL

• JIRA 계정과 연결된 이메일 주소

• JIRA API 토큰(Atlassian 계정 설정에서 생성 가능)

설치

Smithery를 통해 설치

Smithery를 통해 Claude Desktop에 JIRA를 자동으로 설치하는 방법:

npx -y @smithery/cli install jira-mcp --client claude

수동 설치

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

git clone <repository-url>
cd jira-mcp

2. 종속성 설치:

npm install

MCP Inspector로 실행

테스트 및 개발을 위해 MCP Inspector를 사용할 수 있습니다.

npm run inspect

새로운 도구 추가

새로운 도구를 추가하려면 index.js 에서 ListToolsRequestSchema 핸들러를 수정하세요.

server.setRequestHandler(ListToolsRequestSchema, async () => {
  return {
    tools: [
      // Existing tools...
      {
        name: "your_new_tool",
        description: "Description of your new tool",
        inputSchema: {
          // Define input schema...
        }
      }
    ]
  };
});

그런 다음 CallToolRequestSchema 핸들러에서 도구를 구현합니다.

특허

MIT

기여하다

기여를 환영합니다! PR을 제출해 주세요.