Integrates Cursor IDE with Bitbucket Cloud, allowing fetching of repository information, detailed repository data, commit history, commit counts, and latest commit information from Bitbucket workspaces.
Used as the runtime environment for the MCP server, enabling execution of the JavaScript code that powers the Bitbucket integration.
The MCP server is implemented in TypeScript, providing type safety and modern language features for the server implementation.
Bitbucket MCP
A Model Context Protocol (MCP) server that integrates Cursor IDE with Bitbucket Cloud, allowing you to fetch repository information and commit data directly from your Bitbucket workspace.
Features
- List Repositories: Fetch all repositories from your Bitbucket workspace
- Repository Details: Get detailed information about specific repositories
- Commit Information: Retrieve commit history and latest commit details
- Commit Counts: Get total commit counts per repository
- Latest Commit Data: Fetch the most recent commit date, author, and message for each repository
Prerequisites
- Node.js 18 or higher
- npm or yarn
- A Bitbucket Cloud account
- Bitbucket App Password (for authentication)
Setup
1. Install Dependencies
2. Build the Project
3. Create Bitbucket App Password
- Go to your Bitbucket account settings
- Navigate to "App passwords" under "Access management"
- Click "Create app password"
- Give it a descriptive name (e.g., "Cursor MCP Integration")
- Select the following permissions:
- Repositories: Read
- Account: Read (optional, for user info)
- Copy the generated app password
4. Configure Environment Variables
Create a .env
file in the project root:
Note: The workspace name is typically your username or organization name. You can find it in your Bitbucket URLs (e.g., https://bitbucket.org/workspace_name/
).
5. Add to Cursor MCP Configuration
Add the following configuration to your Cursor MCP settings:
For macOS/Linux:
For Windows:
6. Restart Cursor
After adding the configuration, restart Cursor IDE to load the MCP server.
Usage
Once configured, you can use the following tools in Cursor:
1. List Repositories
or
2. Get Repository Details
3. Get Repository Commits
Available Tools
list_repositories
Lists all repositories in your Bitbucket workspace.
Parameters:
include_commit_info
(boolean, optional): Include commit count and latest commit infolimit
(number, optional): Maximum repositories to return (default: 50, max: 100)
get_repository_commits
Gets commit history for a specific repository.
Parameters:
repository_name
(string, required): Name of the repositorylimit
(number, optional): Maximum commits to return (default: 50, max: 100)
get_repository_details
Gets detailed information about a specific repository including latest commit data.
Parameters:
repository_name
(string, required): Name of the repository
Development
Running in Development Mode
Building
Project Structure
Troubleshooting
Authentication Issues
- Verify your Bitbucket username and app password are correct
- Ensure the app password has the correct permissions (Repositories: Read)
- Check that the workspace name is correct
Connection Issues
- Verify your internet connection
- Check if Bitbucket API is accessible from your network
- Ensure the MCP server is running (check Cursor's MCP logs)
Repository Not Found
- Verify the repository name is correct (use the repo slug, not display name)
- Ensure you have access to the repository
- Check that the repository exists in the specified workspace
MCP Server Not Loading
- Verify the path to
dist/index.js
is correct in your Cursor configuration - Ensure Node.js is installed and accessible from the command line
- Check Cursor's MCP server logs for error messages
Security Notes
- Keep your Bitbucket app password secure and never commit it to version control
- Use environment variables or secure configuration management for credentials
- The app password should only have the minimum required permissions
- Consider rotating your app password regularly
Contributing
- Fork the repository
- Create a feature branch
- Make your changes
- Add tests if applicable
- Submit a pull request
License
MIT License - see LICENSE file for details
This server cannot be installed
A Model Context Protocol server that integrates Cursor IDE with Bitbucket Cloud, allowing developers to fetch repository information and commit data directly from their Bitbucket workspace.
Related MCP Servers
- -securityFlicense-qualityA Model Context Protocol server that integrates with Cursor IDE, providing real-time communication, modern web dashboards, and extensible tools via SSE and WebSocket connections.Last updated -7051Python
- -securityFlicense-qualityA Model Context Protocol server that enables AI assistants to explore and interact with Cursor IDE's SQLite databases, providing access to project data, chat history, and composer information.Last updated -10Python
- AsecurityAlicenseAqualityA powerful Model Context Protocol framework that extends Cursor IDE with tools for web content retrieval, PDF processing, and Word document parsing.Last updated -89PythonMIT License
- -securityAlicense-qualityA Model Context Protocol (MCP) server for Cursor IDE that simplifies the installation and configuration of other MCP servers.Last updated -88223JavaScriptMIT License