@atlassian-dc-mcp/bitbucket 0.3.0 → 0.3.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/CHANGELOG.md +8 -0
  2. package/README.md +128 -0
  3. package/package.json +2 -2
package/CHANGELOG.md CHANGED
@@ -3,6 +3,14 @@
3
3
  All notable changes to this project will be documented in this file.
4
4
  See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
5
5
 
6
+ ## [0.3.4](https://github.com/b1ff/atlassian-dc-mcp/compare/v0.3.3...v0.3.4) (2025-03-08)
7
+
8
+ **Note:** Version bump only for package @atlassian-dc-mcp/bitbucket
9
+
10
+
11
+
12
+
13
+
6
14
  # [0.3.0](https://github.com/b1ff/atlassian-dc-mcp/compare/v0.2.1...v0.3.0) (2025-03-03)
7
15
 
8
16
 
package/README.md ADDED
@@ -0,0 +1,128 @@
1
+ # Atlassian Bitbucket Data Center MCP
2
+
3
+ This package provides a Machine Comprehension Protocol (MCP) server for interacting with Atlassian Bitbucket Data Center edition.
4
+
5
+ ## Claude Desktop Configuration
6
+
7
+ To use this MCP connector with Claude Desktop, add the following to your Claude Desktop configuration:
8
+
9
+ macOS:
10
+ ```
11
+ ~/Library/Application Support/Claude/claude_desktop_config.json
12
+ ```
13
+
14
+ Windows:
15
+ ```
16
+ %APPDATA%\Claude\claude_desktop_config.json
17
+ ```
18
+
19
+ ```json
20
+ {
21
+ "mcpServers": {
22
+ "atlassian-bitbucket-dc": {
23
+ "command": "npx",
24
+ "args": ["-y", "@atlassian-dc-mcp/bitbucket"],
25
+ "env": {
26
+ "BITBUCKET_HOST": "your-bitbucket-host",
27
+ "BITBUCKET_API_TOKEN": "your-token"
28
+ }
29
+ }
30
+ }
31
+ }
32
+ ```
33
+
34
+ Note: Set `BITBUCKET_HOST` variable only to domain + port without protocol (e.g., `your-instance.atlassian.net`). The https protocol is assumed.
35
+
36
+ ## Features
37
+
38
+ - Access repository information
39
+ - Get file contents
40
+ - Browse branches and commits
41
+ - Get pull request information
42
+ - Search and filter repositories
43
+
44
+ ## Setup
45
+
46
+ 1. Install dependencies:
47
+ ```
48
+ npm install
49
+ ```
50
+
51
+ 2. Create a `.env` file in the packages/bitbucket directory with the following variables:
52
+ ```
53
+ BITBUCKET_HOST=your-bitbucket-instance.atlassian.net
54
+ BITBUCKET_API_TOKEN=your-personal-access-token
55
+ ```
56
+
57
+ To create a personal access token:
58
+ - In Bitbucket, select your profile picture at the bottom left
59
+ - Select **Manage Account** > **HTTP access tokens**
60
+ - Select **Create token** and give it a name
61
+ - Set appropriate permissions for the token
62
+ - Copy the token and store it securely (you won't be able to see it again)
63
+
64
+ ## Usage
65
+
66
+ Start the MCP server:
67
+
68
+ ```
69
+ npm run build
70
+ npm start
71
+ ```
72
+
73
+ Or for development with auto-reload:
74
+
75
+ ```
76
+ npm run dev
77
+ ```
78
+
79
+ ### Available Tools
80
+
81
+ #### 1. bitbucket_getRepositories
82
+
83
+ Get a list of repositories from the Bitbucket Data Center instance.
84
+
85
+ Parameters:
86
+ - `projectKey` (string, optional): Filter repositories by project key
87
+ - `limit` (number, optional): Maximum number of results to return
88
+ - `start` (number, optional): Starting index for pagination
89
+
90
+ #### 2. bitbucket_getRepository
91
+
92
+ Get details of a specific repository from the Bitbucket Data Center instance.
93
+
94
+ Parameters:
95
+ - `projectKey` (string, required): The project key (e.g., "PROJECT")
96
+ - `repositorySlug` (string, required): The repository slug (e.g., "repo-name")
97
+
98
+ #### 3. bitbucket_getBranches
99
+
100
+ Get branches for a repository from the Bitbucket Data Center instance.
101
+
102
+ Parameters:
103
+ - `projectKey` (string, required): The project key
104
+ - `repositorySlug` (string, required): The repository slug
105
+ - `filterText` (string, optional): Filter branches by name
106
+ - `limit` (number, optional): Maximum number of results to return
107
+ - `start` (number, optional): Starting index for pagination
108
+
109
+ #### 4. bitbucket_getFileContent
110
+
111
+ Get the content of a file from a repository in the Bitbucket Data Center instance.
112
+
113
+ Parameters:
114
+ - `projectKey` (string, required): The project key
115
+ - `repositorySlug` (string, required): The repository slug
116
+ - `path` (string, required): Path to the file in the repository
117
+ - `at` (string, optional): Commit or branch to get the file from (defaults to main/master branch)
118
+
119
+ #### 5. bitbucket_getPullRequests
120
+
121
+ Get pull requests for a repository from the Bitbucket Data Center instance.
122
+
123
+ Parameters:
124
+ - `projectKey` (string, required): The project key
125
+ - `repositorySlug` (string, required): The repository slug
126
+ - `state` (string, optional): Filter by PR state (OPEN, MERGED, DECLINED)
127
+ - `limit` (number, optional): Maximum number of results to return
128
+ - `start` (number, optional): Starting index for pagination
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@atlassian-dc-mcp/bitbucket",
3
- "version": "0.3.0",
3
+ "version": "0.3.4",
4
4
  "main": "build/index.js",
5
5
  "type": "module",
6
6
  "bin": "./bin/run.js",
@@ -29,5 +29,5 @@
29
29
  "publishConfig": {
30
30
  "access": "public"
31
31
  },
32
- "gitHead": "bb9d3190b32e1927d6d7f83172203ea11c0fc160"
32
+ "gitHead": "c376e231e47a6877a981b2601d8a3d4812f21868"
33
33
  }