remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

Allows interaction with JIRA through JQL search queries and retrieving detailed issue information

JIRA MCP 서버

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

특징

JQL 검색 : 페이지네이션 지원을 통해 복잡한 JQL 쿼리 실행
이슈 세부 정보 : 특정 JIRA 이슈에 대한 자세한 정보를 검색합니다.

필수 조건

npm 설치됨
API 액세스가 가능한 JIRA 인스턴스
JIRA API 토큰 또는 개인 액세스 토큰
API 토큰과 연결된 JIRA 사용자 이메일

JIRA API 자격 증명 얻기

https://id.atlassian.com 에서 Atlassian 계정에 로그인하세요.
보안 설정으로 이동
API 토큰에서 "API 토큰 만들기"를 선택하세요.
토큰에 의미 있는 이름을 지정하세요(예: "MCP 서버")
생성된 토큰을 복사하세요. 다시 볼 수 없게 됩니다!
이 토큰을 JIRA_API_KEY 로 사용하세요
Atlassian 계정과 연결된 이메일 주소를 JIRA_USER_EMAIL 로 사용하세요.

용법

Claude Desktop과 통합

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

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

지엑스피1

새로운 구성을 로드하려면 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

수동 설치

이 저장소를 복제하세요:

git clone <repository-url>
cd jira-mcp

종속성 설치:

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을 제출해 주세요.

You must be authenticated.

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

Tools

JQL을 사용하여 Jira 이슈를 검색하고 자세한 이슈 정보를 검색하는 기능을 제공합니다.