@or2ooo/bitbucket-mcp 1.0.0 → 1.0.2
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.
- package/README.md +58 -5
- package/package.json +21 -2
package/README.md
CHANGED
|
@@ -1,6 +1,10 @@
|
|
|
1
1
|
# Bitbucket Cloud MCP Server
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
[](https://github.com/or2ooo/bitbucket-mcp/actions/workflows/ci.yml)
|
|
4
|
+
[](https://www.npmjs.com/package/@or2ooo/bitbucket-mcp)
|
|
5
|
+
[](https://opensource.org/licenses/MIT)
|
|
6
|
+
|
|
7
|
+
A Model Context Protocol (MCP) server for the Bitbucket Cloud REST API v2.0. Works with any MCP client — Claude Code, GitHub Copilot, OpenAI Codex, and more. Provides 26 tools across 5 toolsets with safety controls and compact LLM-optimized output.
|
|
4
8
|
|
|
5
9
|
## Setup
|
|
6
10
|
|
|
@@ -38,7 +42,10 @@ A Model Context Protocol (MCP) server for the Bitbucket Cloud REST API v2.0, des
|
|
|
38
42
|
| `write:issue:bitbucket` | `bb_create_issue`, `bb_comment_issue` |
|
|
39
43
|
| `write:pipeline:bitbucket` | `bb_trigger_pipeline` |
|
|
40
44
|
|
|
41
|
-
### Add to
|
|
45
|
+
### Add to Your MCP Client
|
|
46
|
+
|
|
47
|
+
<details open>
|
|
48
|
+
<summary><strong>Claude Code</strong></summary>
|
|
42
49
|
|
|
43
50
|
One command — no clone or build needed:
|
|
44
51
|
|
|
@@ -46,7 +53,6 @@ One command — no clone or build needed:
|
|
|
46
53
|
claude mcp add bitbucket \
|
|
47
54
|
-e ATLASSIAN_USER_EMAIL=your-email@example.com \
|
|
48
55
|
-e ATLASSIAN_API_TOKEN=your-api-token \
|
|
49
|
-
-e BITBUCKET_DEFAULT_WORKSPACE=your-workspace \
|
|
50
56
|
-e BITBUCKET_READONLY=false \
|
|
51
57
|
-- npx -y @or2ooo/bitbucket-mcp@latest
|
|
52
58
|
```
|
|
@@ -56,8 +62,48 @@ Verify with:
|
|
|
56
62
|
claude mcp list
|
|
57
63
|
```
|
|
58
64
|
|
|
65
|
+
</details>
|
|
66
|
+
|
|
67
|
+
<details>
|
|
68
|
+
<summary><strong>GitHub Copilot (VS Code)</strong></summary>
|
|
69
|
+
|
|
70
|
+
Add to `.vscode/mcp.json` in your project root:
|
|
71
|
+
|
|
72
|
+
```json
|
|
73
|
+
{
|
|
74
|
+
"servers": {
|
|
75
|
+
"bitbucket": {
|
|
76
|
+
"type": "stdio",
|
|
77
|
+
"command": "npx",
|
|
78
|
+
"args": ["-y", "@or2ooo/bitbucket-mcp@latest"],
|
|
79
|
+
"env": {
|
|
80
|
+
"ATLASSIAN_USER_EMAIL": "your-email@example.com",
|
|
81
|
+
"ATLASSIAN_API_TOKEN": "your-api-token",
|
|
82
|
+
"BITBUCKET_READONLY": "false"
|
|
83
|
+
}
|
|
84
|
+
}
|
|
85
|
+
}
|
|
86
|
+
}
|
|
87
|
+
```
|
|
88
|
+
|
|
89
|
+
</details>
|
|
90
|
+
|
|
91
|
+
<details>
|
|
92
|
+
<summary><strong>OpenAI Codex CLI</strong></summary>
|
|
93
|
+
|
|
94
|
+
Add to `~/.codex/config.toml`:
|
|
95
|
+
|
|
96
|
+
```toml
|
|
97
|
+
[mcp_servers.bitbucket]
|
|
98
|
+
command = "npx"
|
|
99
|
+
args = ["-y", "@or2ooo/bitbucket-mcp@latest"]
|
|
100
|
+
env = { ATLASSIAN_USER_EMAIL = "your-email@example.com", ATLASSIAN_API_TOKEN = "your-api-token", BITBUCKET_READONLY = "false" }
|
|
101
|
+
```
|
|
102
|
+
|
|
103
|
+
</details>
|
|
104
|
+
|
|
59
105
|
<details>
|
|
60
|
-
<summary>From source (for development)</summary>
|
|
106
|
+
<summary><strong>From source (for development)</strong></summary>
|
|
61
107
|
|
|
62
108
|
```bash
|
|
63
109
|
git clone https://github.com/or2ooo/bitbucket-mcp.git
|
|
@@ -67,7 +113,6 @@ npm install && npm run build
|
|
|
67
113
|
claude mcp add bitbucket \
|
|
68
114
|
-e ATLASSIAN_USER_EMAIL=your-email@example.com \
|
|
69
115
|
-e ATLASSIAN_API_TOKEN=your-api-token \
|
|
70
|
-
-e BITBUCKET_DEFAULT_WORKSPACE=your-workspace \
|
|
71
116
|
-e BITBUCKET_READONLY=true \
|
|
72
117
|
-- node $(pwd)/dist/index.js
|
|
73
118
|
```
|
|
@@ -149,6 +194,14 @@ npm run lint # Lint
|
|
|
149
194
|
npm run build # Compile
|
|
150
195
|
```
|
|
151
196
|
|
|
197
|
+
## Contributing
|
|
198
|
+
|
|
199
|
+
See [CONTRIBUTING.md](CONTRIBUTING.md) for development setup and guidelines.
|
|
200
|
+
|
|
201
|
+
## Security
|
|
202
|
+
|
|
203
|
+
See [SECURITY.md](SECURITY.md) for reporting vulnerabilities.
|
|
204
|
+
|
|
152
205
|
## License
|
|
153
206
|
|
|
154
207
|
MIT
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@or2ooo/bitbucket-mcp",
|
|
3
|
-
"version": "1.0.
|
|
4
|
-
"description": "MCP server for Bitbucket Cloud REST API
|
|
3
|
+
"version": "1.0.2",
|
|
4
|
+
"description": "MCP server for Bitbucket Cloud REST API — works with any MCP client",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "dist/index.js",
|
|
7
7
|
"bin": {
|
|
@@ -27,6 +27,25 @@
|
|
|
27
27
|
"@modelcontextprotocol/sdk": "^1.12.1",
|
|
28
28
|
"zod": "^3.24.2"
|
|
29
29
|
},
|
|
30
|
+
"author": "Or Booky",
|
|
31
|
+
"license": "MIT",
|
|
32
|
+
"repository": {
|
|
33
|
+
"type": "git",
|
|
34
|
+
"url": "https://github.com/or2ooo/bitbucket-mcp.git"
|
|
35
|
+
},
|
|
36
|
+
"bugs": {
|
|
37
|
+
"url": "https://github.com/or2ooo/bitbucket-mcp/issues"
|
|
38
|
+
},
|
|
39
|
+
"homepage": "https://github.com/or2ooo/bitbucket-mcp#readme",
|
|
40
|
+
"keywords": [
|
|
41
|
+
"mcp",
|
|
42
|
+
"bitbucket",
|
|
43
|
+
"model-context-protocol",
|
|
44
|
+
"bitbucket-cloud",
|
|
45
|
+
"atlassian",
|
|
46
|
+
"copilot",
|
|
47
|
+
"codex"
|
|
48
|
+
],
|
|
30
49
|
"devDependencies": {
|
|
31
50
|
"@eslint/js": "^9.21.0",
|
|
32
51
|
"@types/node": "^22.13.4",
|