Initial commit: Bitbucket MCP server with get_pull_request tool
This commit is contained in:
pdogra1299
commit
b1d758646c
9 changed files with 1909 additions and 0 deletions
42
.gitignore
vendored
Normal file
42
.gitignore
vendored
Normal file
|
|
@ -0,0 +1,42 @@
|
||||||
|
# Dependencies
|
||||||
|
node_modules/
|
||||||
|
|
||||||
|
# Build output
|
||||||
|
build/
|
||||||
|
dist/
|
||||||
|
|
||||||
|
# Environment files
|
||||||
|
.env
|
||||||
|
.env.local
|
||||||
|
.env.*.local
|
||||||
|
|
||||||
|
# IDE files
|
||||||
|
.vscode/
|
||||||
|
.idea/
|
||||||
|
*.swp
|
||||||
|
*.swo
|
||||||
|
*~
|
||||||
|
|
||||||
|
# OS files
|
||||||
|
.DS_Store
|
||||||
|
Thumbs.db
|
||||||
|
|
||||||
|
# Logs
|
||||||
|
logs/
|
||||||
|
*.log
|
||||||
|
npm-debug.log*
|
||||||
|
yarn-debug.log*
|
||||||
|
yarn-error.log*
|
||||||
|
|
||||||
|
# Test files
|
||||||
|
test-api.js
|
||||||
|
*.test.js
|
||||||
|
|
||||||
|
# Temporary files
|
||||||
|
*.tmp
|
||||||
|
*.temp
|
||||||
|
.cache/
|
||||||
|
|
||||||
|
# Personal configuration
|
||||||
|
RELOAD_INSTRUCTIONS.md
|
||||||
|
personal-notes.md
|
||||||
134
README.md
Normal file
134
README.md
Normal file
|
|
@ -0,0 +1,134 @@
|
||||||
|
# Bitbucket MCP Server
|
||||||
|
|
||||||
|
An MCP (Model Context Protocol) server that provides tools for interacting with the Bitbucket API.
|
||||||
|
|
||||||
|
## Features
|
||||||
|
|
||||||
|
Currently implemented:
|
||||||
|
- `get_pull_request` - Retrieve detailed information about a pull request
|
||||||
|
|
||||||
|
Planned features:
|
||||||
|
- `create_pull_request` - Create new pull requests
|
||||||
|
- `list_pull_requests` - List pull requests with filters
|
||||||
|
- `update_pull_request` - Update PR details
|
||||||
|
- `merge_pull_request` - Merge pull requests
|
||||||
|
- And more...
|
||||||
|
|
||||||
|
## Installation
|
||||||
|
|
||||||
|
1. Clone or download this repository
|
||||||
|
2. Install dependencies:
|
||||||
|
```bash
|
||||||
|
npm install
|
||||||
|
```
|
||||||
|
3. Build the TypeScript code:
|
||||||
|
```bash
|
||||||
|
npm run build
|
||||||
|
```
|
||||||
|
|
||||||
|
## Authentication Setup
|
||||||
|
|
||||||
|
This server uses Bitbucket App Passwords for authentication.
|
||||||
|
|
||||||
|
### Creating an App Password
|
||||||
|
|
||||||
|
1. Log in to your Bitbucket account
|
||||||
|
2. Navigate to: https://bitbucket.org/account/settings/app-passwords/
|
||||||
|
3. Click "Create app password"
|
||||||
|
4. Give it a descriptive label (e.g., "MCP Server")
|
||||||
|
5. Select the following permissions:
|
||||||
|
- **Account**: Read
|
||||||
|
- **Repositories**: Read, Write
|
||||||
|
- **Pull requests**: Read, Write
|
||||||
|
6. Click "Create"
|
||||||
|
7. **Important**: Copy the generated password immediately (you won't be able to see it again!)
|
||||||
|
|
||||||
|
### Running the Setup Script
|
||||||
|
|
||||||
|
```bash
|
||||||
|
node scripts/setup-auth.js
|
||||||
|
```
|
||||||
|
|
||||||
|
This will guide you through the authentication setup process.
|
||||||
|
|
||||||
|
## Configuration
|
||||||
|
|
||||||
|
Add the server to your MCP settings file (usually located at `~/.vscode-server/data/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json`):
|
||||||
|
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"mcpServers": {
|
||||||
|
"bitbucket": {
|
||||||
|
"command": "node",
|
||||||
|
"args": ["/absolute/path/to/bitbucket-mcp-server/build/index.js"],
|
||||||
|
"env": {
|
||||||
|
"BITBUCKET_USERNAME": "your-username",
|
||||||
|
"BITBUCKET_APP_PASSWORD": "your-app-password"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
Replace:
|
||||||
|
- `/absolute/path/to/bitbucket-mcp-server` with the actual path to this directory
|
||||||
|
- `your-username` with your Bitbucket username (not email)
|
||||||
|
- `your-app-password` with the app password you created
|
||||||
|
|
||||||
|
For Bitbucket Server, use:
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"mcpServers": {
|
||||||
|
"bitbucket": {
|
||||||
|
"command": "node",
|
||||||
|
"args": ["/absolute/path/to/bitbucket-mcp-server/build/index.js"],
|
||||||
|
"env": {
|
||||||
|
"BITBUCKET_USERNAME": "your-username",
|
||||||
|
"BITBUCKET_TOKEN": "your-http-access-token",
|
||||||
|
"BITBUCKET_BASE_URL": "https://bitbucket.yourcompany.com"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
## Usage
|
||||||
|
|
||||||
|
Once configured, you can use the available tools:
|
||||||
|
|
||||||
|
### Get Pull Request
|
||||||
|
|
||||||
|
```typescript
|
||||||
|
{
|
||||||
|
"tool": "get_pull_request",
|
||||||
|
"arguments": {
|
||||||
|
"workspace": "PROJ", // Required - your project key
|
||||||
|
"repository": "my-repo",
|
||||||
|
"pull_request_id": 123
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
Returns detailed information about the pull request including:
|
||||||
|
- Title and description
|
||||||
|
- Author and reviewers
|
||||||
|
- Source and destination branches
|
||||||
|
- Approval status
|
||||||
|
- Links to web UI and diff
|
||||||
|
- And more...
|
||||||
|
|
||||||
|
## Development
|
||||||
|
|
||||||
|
- `npm run dev` - Watch mode for development
|
||||||
|
- `npm run build` - Build the TypeScript code
|
||||||
|
- `npm start` - Run the built server
|
||||||
|
|
||||||
|
## Troubleshooting
|
||||||
|
|
||||||
|
1. **Authentication errors**: Double-check your username and app password
|
||||||
|
2. **404 errors**: Verify the workspace, repository slug, and PR ID
|
||||||
|
3. **Permission errors**: Ensure your app password has the required permissions
|
||||||
|
|
||||||
|
## License
|
||||||
|
|
||||||
|
MIT
|
||||||
64
SETUP_GUIDE.md
Normal file
64
SETUP_GUIDE.md
Normal file
|
|
@ -0,0 +1,64 @@
|
||||||
|
# Bitbucket MCP Server Setup Guide
|
||||||
|
|
||||||
|
## Step 1: Find Your Bitbucket Username
|
||||||
|
|
||||||
|
1. **Log in to Bitbucket**: Go to https://bitbucket.org and log in with your credentials
|
||||||
|
|
||||||
|
2. **Find your username**:
|
||||||
|
- After logging in, click on your profile avatar in the top-right corner
|
||||||
|
- Click on "Personal settings" or go directly to: https://bitbucket.org/account/settings/
|
||||||
|
- Your username will be displayed at the top of the page
|
||||||
|
- **Note**: Your username is NOT your email address. It's usually a shorter identifier like "johndoe" or "jdoe123"
|
||||||
|
|
||||||
|
## Step 2: Create an App Password
|
||||||
|
|
||||||
|
1. **Navigate to App Passwords**:
|
||||||
|
- While logged in, go to: https://bitbucket.org/account/settings/app-passwords/
|
||||||
|
- Or from your account settings, look for "App passwords" in the left sidebar under "Access management"
|
||||||
|
|
||||||
|
2. **Create a new app password**:
|
||||||
|
- Click the "Create app password" button
|
||||||
|
- Give it a descriptive label like "MCP Server" or "Bitbucket MCP Integration"
|
||||||
|
|
||||||
|
3. **Select permissions** (IMPORTANT - select these specific permissions):
|
||||||
|
- ✅ **Account**: Read
|
||||||
|
- ✅ **Repositories**: Read, Write
|
||||||
|
- ✅ **Pull requests**: Read, Write
|
||||||
|
- You can leave other permissions unchecked
|
||||||
|
|
||||||
|
4. **Generate the password**:
|
||||||
|
- Click "Create"
|
||||||
|
- **IMPORTANT**: Copy the generated password immediately! It will look something like: `ATBBxxxxxxxxxxxxxxxxxxxxx`
|
||||||
|
- You won't be able to see this password again after closing the dialog
|
||||||
|
|
||||||
|
## Step 3: Find Your Workspace (Optional but Recommended)
|
||||||
|
|
||||||
|
Your workspace is the organization or team name in Bitbucket. To find it:
|
||||||
|
|
||||||
|
1. Look at any of your repository URLs:
|
||||||
|
- Example: `https://bitbucket.org/mycompany/my-repo`
|
||||||
|
- In this case, "mycompany" is your workspace
|
||||||
|
|
||||||
|
2. Or go to your workspace dashboard:
|
||||||
|
- Click on "Workspaces" in the top navigation
|
||||||
|
- Your workspaces will be listed there
|
||||||
|
|
||||||
|
## Example Credentials
|
||||||
|
|
||||||
|
Here's what your credentials should look like:
|
||||||
|
|
||||||
|
```
|
||||||
|
Username: johndoe # Your Bitbucket username (NOT email)
|
||||||
|
App Password: ATBB3xXx... # The generated app password
|
||||||
|
Workspace: mycompany # Your organization/workspace name
|
||||||
|
```
|
||||||
|
|
||||||
|
## Common Issues
|
||||||
|
|
||||||
|
1. **"Username not found"**: Make sure you're using your Bitbucket username, not your email address
|
||||||
|
2. **"Invalid app password"**: Ensure you copied the entire app password including the "ATBB" prefix
|
||||||
|
3. **"Permission denied"**: Check that your app password has the required permissions (Account: Read, Repositories: Read/Write, Pull requests: Read/Write)
|
||||||
|
|
||||||
|
## Next Steps
|
||||||
|
|
||||||
|
Once you have these credentials, share them with me and I'll configure the MCP server for you. The credentials will be stored securely in your MCP settings configuration.
|
||||||
61
SETUP_GUIDE_SERVER.md
Normal file
61
SETUP_GUIDE_SERVER.md
Normal file
|
|
@ -0,0 +1,61 @@
|
||||||
|
# Bitbucket Server MCP Setup Guide
|
||||||
|
|
||||||
|
Since you're using Bitbucket Server (self-hosted), you'll need to create an HTTP access token instead of an app password.
|
||||||
|
|
||||||
|
## Step 1: Your Username
|
||||||
|
|
||||||
|
Your Bitbucket Server username (not email address)
|
||||||
|
|
||||||
|
## Step 2: Create an HTTP Access Token
|
||||||
|
|
||||||
|
1. **Navigate to HTTP Access Tokens**:
|
||||||
|
- You mentioned you can see "HTTP access tokens" in your account settings
|
||||||
|
- Click on that option
|
||||||
|
|
||||||
|
2. **Create a new token**:
|
||||||
|
- Click "Create token" or similar button
|
||||||
|
- Give it a descriptive name like "MCP Server Integration"
|
||||||
|
- Set an expiration date (or leave it without expiration if allowed)
|
||||||
|
- Select the following permissions:
|
||||||
|
- **Repository**: Read, Write
|
||||||
|
- **Pull request**: Read, Write
|
||||||
|
- **Project**: Read (if available)
|
||||||
|
|
||||||
|
3. **Generate and copy the token**:
|
||||||
|
- Click "Create" or "Generate"
|
||||||
|
- **IMPORTANT**: Copy the token immediately! It will look like a long string of random characters
|
||||||
|
- You won't be able to see this token again
|
||||||
|
|
||||||
|
## Step 3: Find Your Bitbucket Server URL
|
||||||
|
|
||||||
|
Your Bitbucket Server URL is the base URL you use to access Bitbucket. For example:
|
||||||
|
- `https://bitbucket.yourcompany.com`
|
||||||
|
- `https://git.yourcompany.com`
|
||||||
|
- `https://bitbucket.internal.company.net`
|
||||||
|
|
||||||
|
## Step 4: Find Your Project/Workspace
|
||||||
|
|
||||||
|
In Bitbucket Server, repositories are organized by projects. Look at any repository URL:
|
||||||
|
- Example: `https://bitbucket.company.com/projects/PROJ/repos/my-repo`
|
||||||
|
- In this case, "PROJ" is your project key
|
||||||
|
|
||||||
|
## Example Configuration
|
||||||
|
|
||||||
|
For Bitbucket Server, your configuration will look like:
|
||||||
|
|
||||||
|
```
|
||||||
|
Username: your.username
|
||||||
|
Token: [Your HTTP access token]
|
||||||
|
Base URL: https://bitbucket.yourcompany.com
|
||||||
|
Project/Workspace: PROJ (or whatever your project key is)
|
||||||
|
```
|
||||||
|
|
||||||
|
## Next Steps
|
||||||
|
|
||||||
|
Once you have:
|
||||||
|
1. Your username
|
||||||
|
2. An HTTP access token from the "HTTP access tokens" section
|
||||||
|
3. Your Bitbucket Server base URL
|
||||||
|
4. Your project key
|
||||||
|
|
||||||
|
You can configure the MCP server for Bitbucket Server.
|
||||||
1105
package-lock.json
generated
Normal file
1105
package-lock.json
generated
Normal file
File diff suppressed because it is too large
Load diff
23
package.json
Normal file
23
package.json
Normal file
|
|
@ -0,0 +1,23 @@
|
||||||
|
{
|
||||||
|
"name": "bitbucket-mcp-server",
|
||||||
|
"version": "0.1.0",
|
||||||
|
"description": "MCP server for Bitbucket API integration",
|
||||||
|
"type": "module",
|
||||||
|
"main": "./build/index.js",
|
||||||
|
"scripts": {
|
||||||
|
"build": "tsc && node -e \"require('fs').chmodSync('build/index.js', '755')\"",
|
||||||
|
"dev": "tsc --watch",
|
||||||
|
"start": "node build/index.js"
|
||||||
|
},
|
||||||
|
"keywords": ["mcp", "bitbucket", "api"],
|
||||||
|
"author": "",
|
||||||
|
"license": "MIT",
|
||||||
|
"dependencies": {
|
||||||
|
"@modelcontextprotocol/sdk": "^1.12.1",
|
||||||
|
"axios": "^1.9.0"
|
||||||
|
},
|
||||||
|
"devDependencies": {
|
||||||
|
"@types/node": "^22.15.29",
|
||||||
|
"typescript": "^5.8.3"
|
||||||
|
}
|
||||||
|
}
|
||||||
48
scripts/setup-auth.js
Normal file
48
scripts/setup-auth.js
Normal file
|
|
@ -0,0 +1,48 @@
|
||||||
|
#!/usr/bin/env node
|
||||||
|
|
||||||
|
console.log(`
|
||||||
|
===========================================
|
||||||
|
Bitbucket MCP Server - Authentication Setup
|
||||||
|
===========================================
|
||||||
|
|
||||||
|
To use this MCP server, you need to create a Bitbucket App Password.
|
||||||
|
|
||||||
|
Follow these steps:
|
||||||
|
|
||||||
|
1. Log in to your Bitbucket account
|
||||||
|
2. Go to: https://bitbucket.org/account/settings/app-passwords/
|
||||||
|
3. Click "Create app password"
|
||||||
|
4. Give it a label (e.g., "MCP Server")
|
||||||
|
5. Select the following permissions:
|
||||||
|
- Account: Read
|
||||||
|
- Repositories: Read, Write
|
||||||
|
- Pull requests: Read, Write
|
||||||
|
6. Click "Create"
|
||||||
|
7. Copy the generated app password (you won't be able to see it again!)
|
||||||
|
|
||||||
|
You'll need to provide:
|
||||||
|
- Your Bitbucket username (not email)
|
||||||
|
- The app password you just created
|
||||||
|
- Your default workspace/organization (optional)
|
||||||
|
|
||||||
|
Example workspace: If your repository URL is:
|
||||||
|
https://bitbucket.org/mycompany/my-repo
|
||||||
|
Then your workspace is: mycompany
|
||||||
|
|
||||||
|
These will be added to your MCP settings configuration.
|
||||||
|
|
||||||
|
Press Enter to continue...
|
||||||
|
`);
|
||||||
|
|
||||||
|
// Wait for user to press Enter
|
||||||
|
process.stdin.once('data', () => {
|
||||||
|
console.log(`
|
||||||
|
Next steps:
|
||||||
|
1. The MCP server will be configured with your credentials
|
||||||
|
2. You'll be able to use the 'get_pull_request' tool
|
||||||
|
3. More tools can be added later (create_pull_request, list_pull_requests, etc.)
|
||||||
|
|
||||||
|
Configuration complete!
|
||||||
|
`);
|
||||||
|
process.exit(0);
|
||||||
|
});
|
||||||
413
src/index.ts
Normal file
413
src/index.ts
Normal file
|
|
@ -0,0 +1,413 @@
|
||||||
|
#!/usr/bin/env node
|
||||||
|
import { Server } from '@modelcontextprotocol/sdk/server/index.js';
|
||||||
|
import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
|
||||||
|
import {
|
||||||
|
CallToolRequestSchema,
|
||||||
|
ErrorCode,
|
||||||
|
ListToolsRequestSchema,
|
||||||
|
McpError,
|
||||||
|
} from '@modelcontextprotocol/sdk/types.js';
|
||||||
|
import axios, { AxiosInstance } from 'axios';
|
||||||
|
|
||||||
|
// Get environment variables
|
||||||
|
const BITBUCKET_USERNAME = process.env.BITBUCKET_USERNAME;
|
||||||
|
const BITBUCKET_APP_PASSWORD = process.env.BITBUCKET_APP_PASSWORD;
|
||||||
|
const BITBUCKET_TOKEN = process.env.BITBUCKET_TOKEN; // For Bitbucket Server
|
||||||
|
const BITBUCKET_WORKSPACE = process.env.BITBUCKET_WORKSPACE;
|
||||||
|
const BITBUCKET_BASE_URL = process.env.BITBUCKET_BASE_URL || 'https://api.bitbucket.org/2.0';
|
||||||
|
|
||||||
|
// Check for either app password (Cloud) or token (Server)
|
||||||
|
if (!BITBUCKET_USERNAME || (!BITBUCKET_APP_PASSWORD && !BITBUCKET_TOKEN)) {
|
||||||
|
console.error('Error: BITBUCKET_USERNAME and either BITBUCKET_APP_PASSWORD (for Cloud) or BITBUCKET_TOKEN (for Server) are required');
|
||||||
|
console.error('Please set these in your MCP settings configuration');
|
||||||
|
process.exit(1);
|
||||||
|
}
|
||||||
|
|
||||||
|
// Note: BITBUCKET_WORKSPACE is optional - it should be passed when invoking the tool
|
||||||
|
|
||||||
|
// Bitbucket Server API response types
|
||||||
|
interface BitbucketServerPullRequest {
|
||||||
|
id: number;
|
||||||
|
version: number;
|
||||||
|
title: string;
|
||||||
|
description?: string;
|
||||||
|
state: string;
|
||||||
|
open: boolean;
|
||||||
|
closed: boolean;
|
||||||
|
createdDate: number;
|
||||||
|
updatedDate: number;
|
||||||
|
fromRef: {
|
||||||
|
id: string;
|
||||||
|
displayId: string;
|
||||||
|
latestCommit: string;
|
||||||
|
repository: {
|
||||||
|
slug: string;
|
||||||
|
name: string;
|
||||||
|
project: {
|
||||||
|
key: string;
|
||||||
|
};
|
||||||
|
};
|
||||||
|
};
|
||||||
|
toRef: {
|
||||||
|
id: string;
|
||||||
|
displayId: string;
|
||||||
|
latestCommit: string;
|
||||||
|
repository: {
|
||||||
|
slug: string;
|
||||||
|
name: string;
|
||||||
|
project: {
|
||||||
|
key: string;
|
||||||
|
};
|
||||||
|
};
|
||||||
|
};
|
||||||
|
locked: boolean;
|
||||||
|
author: {
|
||||||
|
user: {
|
||||||
|
name: string;
|
||||||
|
emailAddress: string;
|
||||||
|
displayName: string;
|
||||||
|
};
|
||||||
|
role: string;
|
||||||
|
approved: boolean;
|
||||||
|
status: string;
|
||||||
|
};
|
||||||
|
reviewers: Array<{
|
||||||
|
user: {
|
||||||
|
name: string;
|
||||||
|
emailAddress: string;
|
||||||
|
displayName: string;
|
||||||
|
};
|
||||||
|
role: string;
|
||||||
|
approved: boolean;
|
||||||
|
status: string;
|
||||||
|
}>;
|
||||||
|
participants: Array<{
|
||||||
|
user: {
|
||||||
|
name: string;
|
||||||
|
emailAddress: string;
|
||||||
|
displayName: string;
|
||||||
|
};
|
||||||
|
role: string;
|
||||||
|
approved: boolean;
|
||||||
|
status: string;
|
||||||
|
}>;
|
||||||
|
links: {
|
||||||
|
self: Array<{
|
||||||
|
href: string;
|
||||||
|
}>;
|
||||||
|
};
|
||||||
|
}
|
||||||
|
|
||||||
|
// Bitbucket Cloud API response types (keeping for compatibility)
|
||||||
|
interface BitbucketCloudPullRequest {
|
||||||
|
id: number;
|
||||||
|
title: string;
|
||||||
|
description: string;
|
||||||
|
state: string;
|
||||||
|
author: {
|
||||||
|
display_name: string;
|
||||||
|
account_id: string;
|
||||||
|
};
|
||||||
|
source: {
|
||||||
|
branch: {
|
||||||
|
name: string;
|
||||||
|
};
|
||||||
|
repository: {
|
||||||
|
full_name: string;
|
||||||
|
};
|
||||||
|
};
|
||||||
|
destination: {
|
||||||
|
branch: {
|
||||||
|
name: string;
|
||||||
|
};
|
||||||
|
repository: {
|
||||||
|
full_name: string;
|
||||||
|
};
|
||||||
|
};
|
||||||
|
reviewers: Array<{
|
||||||
|
display_name: string;
|
||||||
|
account_id: string;
|
||||||
|
}>;
|
||||||
|
participants: Array<{
|
||||||
|
user: {
|
||||||
|
display_name: string;
|
||||||
|
account_id: string;
|
||||||
|
};
|
||||||
|
role: string;
|
||||||
|
approved: boolean;
|
||||||
|
}>;
|
||||||
|
created_on: string;
|
||||||
|
updated_on: string;
|
||||||
|
links: {
|
||||||
|
html: {
|
||||||
|
href: string;
|
||||||
|
};
|
||||||
|
self: {
|
||||||
|
href: string;
|
||||||
|
};
|
||||||
|
diff: {
|
||||||
|
href: string;
|
||||||
|
};
|
||||||
|
};
|
||||||
|
merge_commit?: {
|
||||||
|
hash: string;
|
||||||
|
};
|
||||||
|
close_source_branch: boolean;
|
||||||
|
closed_by?: {
|
||||||
|
display_name: string;
|
||||||
|
account_id: string;
|
||||||
|
};
|
||||||
|
}
|
||||||
|
|
||||||
|
// Type guard for tool arguments
|
||||||
|
const isGetPullRequestArgs = (
|
||||||
|
args: any
|
||||||
|
): args is { workspace: string; repository: string; pull_request_id: number } =>
|
||||||
|
typeof args === 'object' &&
|
||||||
|
args !== null &&
|
||||||
|
typeof args.workspace === 'string' &&
|
||||||
|
typeof args.repository === 'string' &&
|
||||||
|
typeof args.pull_request_id === 'number';
|
||||||
|
|
||||||
|
class BitbucketMCPServer {
|
||||||
|
private server: Server;
|
||||||
|
private axiosInstance: AxiosInstance;
|
||||||
|
private isServer: boolean;
|
||||||
|
|
||||||
|
constructor() {
|
||||||
|
this.isServer = !!BITBUCKET_TOKEN;
|
||||||
|
|
||||||
|
this.server = new Server(
|
||||||
|
{
|
||||||
|
name: 'bitbucket-mcp-server',
|
||||||
|
version: '0.1.0',
|
||||||
|
},
|
||||||
|
{
|
||||||
|
capabilities: {
|
||||||
|
tools: {},
|
||||||
|
},
|
||||||
|
}
|
||||||
|
);
|
||||||
|
|
||||||
|
// Create axios instance with appropriate auth
|
||||||
|
const axiosConfig: any = {
|
||||||
|
baseURL: BITBUCKET_BASE_URL,
|
||||||
|
headers: {
|
||||||
|
'Content-Type': 'application/json',
|
||||||
|
},
|
||||||
|
};
|
||||||
|
|
||||||
|
// Use token auth for Bitbucket Server, basic auth for Cloud
|
||||||
|
if (BITBUCKET_TOKEN) {
|
||||||
|
// Bitbucket Server uses Bearer token
|
||||||
|
axiosConfig.headers['Authorization'] = `Bearer ${BITBUCKET_TOKEN}`;
|
||||||
|
} else {
|
||||||
|
// Bitbucket Cloud uses basic auth with app password
|
||||||
|
axiosConfig.auth = {
|
||||||
|
username: BITBUCKET_USERNAME!,
|
||||||
|
password: BITBUCKET_APP_PASSWORD!,
|
||||||
|
};
|
||||||
|
}
|
||||||
|
|
||||||
|
this.axiosInstance = axios.create(axiosConfig);
|
||||||
|
|
||||||
|
this.setupToolHandlers();
|
||||||
|
|
||||||
|
// Error handling
|
||||||
|
this.server.onerror = (error) => console.error('[MCP Error]', error);
|
||||||
|
process.on('SIGINT', async () => {
|
||||||
|
await this.server.close();
|
||||||
|
process.exit(0);
|
||||||
|
});
|
||||||
|
}
|
||||||
|
|
||||||
|
private formatServerResponse(pr: BitbucketServerPullRequest): any {
|
||||||
|
const webUrl = `${BITBUCKET_BASE_URL}/projects/${pr.toRef.repository.project.key}/repos/${pr.toRef.repository.slug}/pull-requests/${pr.id}`;
|
||||||
|
|
||||||
|
return {
|
||||||
|
id: pr.id,
|
||||||
|
title: pr.title,
|
||||||
|
description: pr.description || 'No description provided',
|
||||||
|
state: pr.state,
|
||||||
|
is_open: pr.open,
|
||||||
|
is_closed: pr.closed,
|
||||||
|
author: pr.author.user.displayName,
|
||||||
|
author_email: pr.author.user.emailAddress,
|
||||||
|
source_branch: pr.fromRef.displayId,
|
||||||
|
destination_branch: pr.toRef.displayId,
|
||||||
|
source_commit: pr.fromRef.latestCommit,
|
||||||
|
destination_commit: pr.toRef.latestCommit,
|
||||||
|
reviewers: pr.reviewers.map(r => ({
|
||||||
|
name: r.user.displayName,
|
||||||
|
approved: r.approved,
|
||||||
|
status: r.status,
|
||||||
|
})),
|
||||||
|
participants: pr.participants.map(p => ({
|
||||||
|
name: p.user.displayName,
|
||||||
|
role: p.role,
|
||||||
|
approved: p.approved,
|
||||||
|
status: p.status,
|
||||||
|
})),
|
||||||
|
created_on: new Date(pr.createdDate).toLocaleString(),
|
||||||
|
updated_on: new Date(pr.updatedDate).toLocaleString(),
|
||||||
|
web_url: webUrl,
|
||||||
|
api_url: pr.links.self[0]?.href || '',
|
||||||
|
is_locked: pr.locked,
|
||||||
|
};
|
||||||
|
}
|
||||||
|
|
||||||
|
private formatCloudResponse(pr: BitbucketCloudPullRequest): any {
|
||||||
|
return {
|
||||||
|
id: pr.id,
|
||||||
|
title: pr.title,
|
||||||
|
description: pr.description || 'No description provided',
|
||||||
|
state: pr.state,
|
||||||
|
author: pr.author.display_name,
|
||||||
|
source_branch: pr.source.branch.name,
|
||||||
|
destination_branch: pr.destination.branch.name,
|
||||||
|
reviewers: pr.reviewers.map(r => r.display_name),
|
||||||
|
participants: pr.participants.map(p => ({
|
||||||
|
name: p.user.display_name,
|
||||||
|
role: p.role,
|
||||||
|
approved: p.approved,
|
||||||
|
})),
|
||||||
|
created_on: new Date(pr.created_on).toLocaleString(),
|
||||||
|
updated_on: new Date(pr.updated_on).toLocaleString(),
|
||||||
|
web_url: pr.links.html.href,
|
||||||
|
api_url: pr.links.self.href,
|
||||||
|
diff_url: pr.links.diff.href,
|
||||||
|
is_merged: pr.state === 'MERGED',
|
||||||
|
merge_commit: pr.merge_commit?.hash,
|
||||||
|
close_source_branch: pr.close_source_branch,
|
||||||
|
closed_by: pr.closed_by?.display_name,
|
||||||
|
};
|
||||||
|
}
|
||||||
|
|
||||||
|
private setupToolHandlers() {
|
||||||
|
// List available tools
|
||||||
|
this.server.setRequestHandler(ListToolsRequestSchema, async () => ({
|
||||||
|
tools: [
|
||||||
|
{
|
||||||
|
name: 'get_pull_request',
|
||||||
|
description: 'Get details of a Bitbucket pull request',
|
||||||
|
inputSchema: {
|
||||||
|
type: 'object',
|
||||||
|
properties: {
|
||||||
|
workspace: {
|
||||||
|
type: 'string',
|
||||||
|
description: 'Bitbucket workspace/project key (e.g., "JBIZ")',
|
||||||
|
},
|
||||||
|
repository: {
|
||||||
|
type: 'string',
|
||||||
|
description: 'Repository slug (e.g., "my-repo")',
|
||||||
|
},
|
||||||
|
pull_request_id: {
|
||||||
|
type: 'number',
|
||||||
|
description: 'Pull request ID',
|
||||||
|
},
|
||||||
|
},
|
||||||
|
required: ['workspace', 'repository', 'pull_request_id'],
|
||||||
|
},
|
||||||
|
},
|
||||||
|
],
|
||||||
|
}));
|
||||||
|
|
||||||
|
// Handle tool calls
|
||||||
|
this.server.setRequestHandler(CallToolRequestSchema, async (request) => {
|
||||||
|
if (request.params.name !== 'get_pull_request') {
|
||||||
|
throw new McpError(
|
||||||
|
ErrorCode.MethodNotFound,
|
||||||
|
`Unknown tool: ${request.params.name}`
|
||||||
|
);
|
||||||
|
}
|
||||||
|
|
||||||
|
if (!isGetPullRequestArgs(request.params.arguments)) {
|
||||||
|
throw new McpError(
|
||||||
|
ErrorCode.InvalidParams,
|
||||||
|
'Invalid arguments for get_pull_request'
|
||||||
|
);
|
||||||
|
}
|
||||||
|
|
||||||
|
const { workspace, repository, pull_request_id } = request.params.arguments;
|
||||||
|
|
||||||
|
try {
|
||||||
|
// Different API paths for Server vs Cloud
|
||||||
|
const apiPath = this.isServer
|
||||||
|
? `/rest/api/1.0/projects/${workspace}/repos/${repository}/pull-requests/${pull_request_id}` // Server
|
||||||
|
: `/repositories/${workspace}/${repository}/pullrequests/${pull_request_id}`; // Cloud
|
||||||
|
|
||||||
|
console.error(`[DEBUG] Fetching PR from: ${BITBUCKET_BASE_URL}${apiPath}`);
|
||||||
|
|
||||||
|
const response = await this.axiosInstance.get(apiPath);
|
||||||
|
const pr = response.data;
|
||||||
|
|
||||||
|
// Format the response based on server type
|
||||||
|
const formattedResponse = this.isServer
|
||||||
|
? this.formatServerResponse(pr as BitbucketServerPullRequest)
|
||||||
|
: this.formatCloudResponse(pr as BitbucketCloudPullRequest);
|
||||||
|
|
||||||
|
return {
|
||||||
|
content: [
|
||||||
|
{
|
||||||
|
type: 'text',
|
||||||
|
text: JSON.stringify(formattedResponse, null, 2),
|
||||||
|
},
|
||||||
|
],
|
||||||
|
};
|
||||||
|
} catch (error) {
|
||||||
|
if (axios.isAxiosError(error)) {
|
||||||
|
const status = error.response?.status;
|
||||||
|
const message = error.response?.data?.errors?.[0]?.message ||
|
||||||
|
error.response?.data?.error?.message ||
|
||||||
|
error.response?.data?.message ||
|
||||||
|
error.message;
|
||||||
|
|
||||||
|
console.error(`[DEBUG] API Error: ${status} - ${message}`);
|
||||||
|
console.error(`[DEBUG] Full error response:`, error.response?.data);
|
||||||
|
|
||||||
|
if (status === 404) {
|
||||||
|
return {
|
||||||
|
content: [
|
||||||
|
{
|
||||||
|
type: 'text',
|
||||||
|
text: `Pull request not found: ${workspace}/${repository}/pull-requests/${pull_request_id}`,
|
||||||
|
},
|
||||||
|
],
|
||||||
|
isError: true,
|
||||||
|
};
|
||||||
|
} else if (status === 401) {
|
||||||
|
return {
|
||||||
|
content: [
|
||||||
|
{
|
||||||
|
type: 'text',
|
||||||
|
text: `Authentication failed. Please check your ${this.isServer ? 'BITBUCKET_TOKEN' : 'BITBUCKET_USERNAME and BITBUCKET_APP_PASSWORD'}`,
|
||||||
|
},
|
||||||
|
],
|
||||||
|
isError: true,
|
||||||
|
};
|
||||||
|
}
|
||||||
|
|
||||||
|
return {
|
||||||
|
content: [
|
||||||
|
{
|
||||||
|
type: 'text',
|
||||||
|
text: `Bitbucket API error: ${message}`,
|
||||||
|
},
|
||||||
|
],
|
||||||
|
isError: true,
|
||||||
|
};
|
||||||
|
}
|
||||||
|
throw error;
|
||||||
|
}
|
||||||
|
});
|
||||||
|
}
|
||||||
|
|
||||||
|
async run() {
|
||||||
|
const transport = new StdioServerTransport();
|
||||||
|
await this.server.connect(transport);
|
||||||
|
console.error(`Bitbucket MCP server running on stdio (${this.isServer ? 'Server' : 'Cloud'} mode)`);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
const server = new BitbucketMCPServer();
|
||||||
|
server.run().catch(console.error);
|
||||||
19
tsconfig.json
Normal file
19
tsconfig.json
Normal file
|
|
@ -0,0 +1,19 @@
|
||||||
|
{
|
||||||
|
"compilerOptions": {
|
||||||
|
"target": "ES2022",
|
||||||
|
"module": "Node16",
|
||||||
|
"moduleResolution": "Node16",
|
||||||
|
"outDir": "./build",
|
||||||
|
"rootDir": "./src",
|
||||||
|
"strict": true,
|
||||||
|
"esModuleInterop": true,
|
||||||
|
"skipLibCheck": true,
|
||||||
|
"forceConsistentCasingInFileNames": true,
|
||||||
|
"resolveJsonModule": true,
|
||||||
|
"declaration": true,
|
||||||
|
"declarationMap": true,
|
||||||
|
"sourceMap": true
|
||||||
|
},
|
||||||
|
"include": ["src/**/*"],
|
||||||
|
"exclude": ["node_modules", "build"]
|
||||||
|
}
|
||||||
Loading…
Reference in a new issue