Atlassian Bitbucket MCP 서버

이 프로젝트는 AI 어시스턴트(Anthropic의 Claude, Cursor AI 또는 기타 MCP 호환 클라이언트 등)와 Atlassian Bitbucket 인스턴스를 연결하는 모델 컨텍스트 프로토콜(MCP) 서버를 제공합니다. 이를 통해 AI는 실시간으로 저장소, 풀 리퀘스트 및 작업 공간에 안전하게 액세스하고 상호작용할 수 있습니다.

개요

MCP란 무엇인가요?

MCP(Model Context Protocol)는 AI 시스템이 외부 도구 및 데이터 소스와 안전하고 상황에 맞게 연결할 수 있도록 하는 개방형 표준입니다.

이 서버는 Bitbucket Cloud를 위해 특별히 MCP를 구현하여 Bitbucket 데이터와 AI 어시스턴트를 연결합니다.

왜 이 서버를 사용해야 하나요?

최소 입력, 최대 출력 철학 : workspaceSlug 및 repoSlug 와 같은 간단한 식별자만 있으면 됩니다. 각 도구는 추가 플래그 없이도 포괄적인 세부 정보를 반환합니다.
풍부한 코드 시각화 : 파일 통계, 차이점 보기, 코드 수정에 대한 스마트 컨텍스트를 통해 저장소와 코드 변경에 대한 자세한 통찰력을 얻으세요.
안전한 로컬 인증 : 자격 증명은 서버에 저장되지 않습니다. 서버는 로컬에서 실행되므로 토큰이 사용자 컴퓨터 외부로 유출되지 않으며, 필요한 권한만 요청할 수 있습니다.
직관적인 마크다운 응답 : 모든 응답은 일관된 서식과 탐색 링크를 통해 가독성을 높이기 위해 잘 구성된 마크다운을 사용합니다.
전체 Bitbucket 통합 : 통합된 인터페이스를 통해 작업 공간, 저장소, 풀 리퀘스트, 댓글, 코드 검색 등에 액세스하세요.

시작하기

필수 조건

Node.js (>=18.x): 다운로드
Bitbucket 클라우드 계정

1단계: 인증

다음 인증 방법 중 하나를 선택하세요.

옵션 A: Bitbucket 앱 비밀번호(권장)

Bitbucket 앱 비밀번호 에서 생성하세요. 최소 권한:

작업 공간: 읽기
저장소: 읽기
풀 리퀘스트: 읽기

옵션 B: Atlassian API 토큰

Atlassian API 토큰 에서 하나를 생성합니다.

2단계: 자격 증명 구성

방법 A: MCP 구성 파일(권장)

~/.mcp/configs.json 생성하거나 편집합니다.

Bitbucket 앱 비밀번호 사용:

지엑스피1

Atlassian API 토큰 사용:

{
	"@aashari/mcp-server-atlassian-bitbucket": {
		"environments": {
			"ATLASSIAN_SITE_NAME": "bitbucket",
			"ATLASSIAN_USER_EMAIL": "<your_email>",
			"ATLASSIAN_API_TOKEN": "<your_api_token>"
		}
	}
}

방법 B: 환경 변수

서버를 실행할 때 자격 증명을 직접 전달합니다.

ATLASSIAN_BITBUCKET_USERNAME="<your_username>" \
ATLASSIAN_BITBUCKET_APP_PASSWORD="<your_app_password>" \
npx -y @aashari/mcp-server-atlassian-bitbucket

3단계: AI 도우미 연결

이 서버를 실행하려면 MCP 호환 클라이언트를 구성하세요.

Claude / 커서 구성:

{
	"mcpServers": {
		"aashari/mcp-server-atlassian-bitbucket": {
			"command": "npx",
			"args": ["-y", "@aashari/mcp-server-atlassian-bitbucket"]
		}
	}
}

이 구성을 사용하면 런타임에 서버가 자동으로 시작됩니다.

도구

이 섹션에서는 이 서버를 AI 어시스턴트와 함께 사용할 때 사용할 수 있는 MCP 도구에 대해 설명합니다. MCP 도구는 도구 이름에는 snake_case , 매개변수에는 camelCase 사용합니다.

`list_workspaces`

사용 가능한 Bitbucket 작업 공간을 나열합니다.

{}

또는:

{ "query": "devteam" }

"내 Bitbucket 작업 공간을 모두 보여주세요."

`get_workspace`

특정 작업 공간에 대한 전체 세부 정보를 얻으세요.

{ "workspaceSlug": "acme-corp" }

"acme-corp의 업무 공간에 대해 더 자세히 알려주세요."

`list_repositories`

작업 공간의 저장소를 나열합니다.

{ "workspaceSlug": "acme-corp" }

또는:

{ "workspaceSlug": "acme-corp", "query": "api" }

"acme-corp의 저장소를 나열하세요."

`get_repository`

특정 저장소의 세부 정보를 가져옵니다.

{ "workspaceSlug": "acme-corp", "repoSlug": "backend-api" }

"'acme-corp'의 'backend-api' 저장소를 보여주세요."

`search`

Bitbucket 콘텐츠를 검색합니다.

저장소:

{ "workspaceSlug": "acme-corp", "query": "api", "scope": "repositories" }

풀 리퀘스트:

{
	"workspaceSlug": "acme-corp",
	"repoSlug": "backend-api",
	"query": "fix",
	"scope": "pullrequests"
}

커밋:

{
	"workspaceSlug": "acme-corp",
	"repoSlug": "backend-api",
	"query": "update",
	"scope": "commits"
}

암호:

{ "workspaceSlug": "acme-corp", "query": "function getUser", "scope": "code" }

'acme-corp' 작업 공간에서 'function getUser'를 검색하세요.

`list_pull_requests`

저장소에 풀 리퀘스트를 나열합니다.

{ "workspaceSlug": "acme-corp", "repoSlug": "frontend-app", "state": "OPEN" }

"'frontend-app'에서 열려 있는 PR을 표시합니다."

`get_pull_request`

코드 차이점과 파일 변경 사항을 포함한 풀 리퀘스트의 전체 세부 정보를 얻으세요.

{ "workspaceSlug": "acme-corp", "repoSlug": "frontend-app", "prId": "42" }

"모든 코드 변경 사항을 포함하여 'frontend-app'에서 PR #42를 가져옵니다."

`list_pr_comments`

특정 풀 리퀘스트에 대한 댓글을 나열합니다.

{ "workspaceSlug": "acme-corp", "repoSlug": "frontend-app", "prId": "42" }

"PR #42에 대한 모든 댓글을 보여주세요."

`add_pr_comment`

풀 리퀘스트에 댓글을 추가합니다.

일반적인:

{
	"workspaceSlug": "acme-corp",
	"repoSlug": "frontend-app",
	"prId": "42",
	"content": "Looks good."
}

인라인:

{
	"workspaceSlug": "acme-corp",
	"repoSlug": "frontend-app",
	"prId": "42",
	"content": "Consider refactoring.",
	"inline": { "path": "src/utils.js", "line": 42 }
}

"PR #42의 42번째 줄에 주석을 추가하세요."

`pull_requests_create`

새로운 풀 리퀘스트를 만듭니다.

{
	"workspaceSlug": "acme-corp",
	"repoSlug": "frontend-app",
	"title": "Add login screen",
	"sourceBranch": "feature/login"
}

"'기능/로그인'에서 '메인'으로 PR을 만듭니다."

명령줄 인터페이스(CLI)

CLI는 명령(예: list-workspaces )과 옵션(예: --workspace-slug )에 케밥 케이스를 사용합니다.

`npx` 로 빠르게 사용하기

npx -y @aashari/mcp-server-atlassian-bitbucket list-workspaces
npx -y @aashari/mcp-server-atlassian-bitbucket get-repository \
  --workspace-slug acme-corp \
  --repo-slug backend-api

글로벌 설치

npm install -g @aashari/mcp-server-atlassian-bitbucket

그런 다음 직접 실행하세요.

mcp-atlassian-bitbucket list-workspaces

더 많은 CLI 옵션 알아보기

--help 사용하면 사용 가능한 모든 명령에 대한 플래그와 사용법을 확인할 수 있습니다.

mcp-atlassian-bitbucket --help

또는 특정 명령에 대한 자세한 도움말을 받으세요.

mcp-atlassian-bitbucket get-repository --help
mcp-atlassian-bitbucket list-pull-requests --help
mcp-atlassian-bitbucket search --help

특허

ISC 라이센스

Atlassian Bitbucket MCP Server

Integrations

Atlassian Bitbucket MCP 서버

개요

MCP란 무엇인가요?

왜 이 서버를 사용해야 하나요?

시작하기

필수 조건

1단계: 인증

옵션 A: Bitbucket 앱 비밀번호(권장)

옵션 B: Atlassian API 토큰

2단계: 자격 증명 구성

방법 A: MCP 구성 파일(권장)

방법 B: 환경 변수

3단계: AI 도우미 연결

도구

`list_workspaces`

`get_workspace`

`list_repositories`

`get_repository`

`search`

`list_pull_requests`

`get_pull_request`

`list_pr_comments`

`add_pr_comment`

`pull_requests_create`

명령줄 인터페이스(CLI)

`npx` 로 빠르게 사용하기

글로벌 설치

더 많은 CLI 옵션 알아보기

특허

Tools

Appeared in Searches

Integrations

Atlassian Bitbucket MCP 서버

개요

MCP란 무엇인가요?

왜 이 서버를 사용해야 하나요?

시작하기

필수 조건

1단계: 인증

옵션 A: Bitbucket 앱 비밀번호(권장)

옵션 B: Atlassian API 토큰

2단계: 자격 증명 구성

방법 A: MCP 구성 파일(권장)

방법 B: 환경 변수

3단계: AI 도우미 연결

도구

list_workspaces

get_workspace

list_repositories

get_repository

search

list_pull_requests

get_pull_request

list_pr_comments

add_pr_comment

pull_requests_create

명령줄 인터페이스(CLI)

npx 로 빠르게 사용하기

글로벌 설치

더 많은 CLI 옵션 알아보기

특허

Tools

Appeared in Searches

`list_workspaces`

`get_workspace`

`list_repositories`

`get_repository`

`search`

`list_pull_requests`

`get_pull_request`

`list_pr_comments`

`add_pr_comment`

`pull_requests_create`

`npx` 로 빠르게 사용하기