stash-mcp
Provides tools for Bitbucket Server/Data Center, enabling project and repository discovery, pull request lifecycle management (create, review, merge, decline), comment management, diff viewing with truncation, and code search.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
Stash MCP
Professional MCP (Model Context Protocol) server for Bitbucket Server/Data Center (formerly Stash). It provides high-signal tools for project discovery, repository browsing, pull request workflows, and code search.
Features
Project and repository discovery
Pull request lifecycle management (create, review, merge, decline)
Commenting and inline review notes
Diff viewing with safe truncation for large files
Code search (when enabled on the server)
Read-only mode to prevent write operations
Related MCP server: Bitbucket MCP Server
Requirements
Node.js 18+
Bitbucket Server/Data Center (Stash) REST API access
Install
npm install
npm run buildOr use the helper script:
./scripts/install.shConfiguration
Add to ~/.claude/user-mcps.json:
{
"mcpServers": {
"stash": {
"command": "node",
"args": ["/absolute/path/to/stash-mcp/dist/index.js"],
"env": {
"BITBUCKET_URL": "https://stash.example.com",
"BITBUCKET_TOKEN": "your-access-token",
"BITBUCKET_DEFAULT_PROJECT": "PROJ"
}
}
}
}Environment Variables
BITBUCKET_URL(required): Base URL of your Bitbucket Server instance.BITBUCKET_TOKEN: Personal access token (recommended).BITBUCKET_USERNAME/BITBUCKET_PASSWORD: Basic auth alternative.BITBUCKET_DEFAULT_PROJECT: Default project key whenprojectis omitted.BITBUCKET_DIFF_MAX_LINES_PER_FILE: Diff truncation limit per file.BITBUCKET_READ_ONLY: Set totrueto disable write operations.
Dependencies
Hermes — Authentication broker. Manages OAuth2/SSO token acquisition, refresh, and serving for this MCP server.
ToolHive — Container runtime. Hosts this server as a Docker container with streamable HTTP transport.
MCP Gateway — Aggregation layer. Provides unified tool access across all MCP backends.
node-vault-mcp — Credential storage. AES-256-GCM encrypted file vault (replaces macOS Keychain/keytar).
Architecture
This MCP server runs as a Docker container managed by ToolHive:
Container — Built from the local Dockerfile and published as
localhost:5555/stash-mcp:latestTransport — Streamable HTTP via the ToolHive proxy
Authentication — Managed by Hermes (
http://127.0.0.1:9876)Discovery — Exposed through MCP Gateway at
http://127.0.0.1:3100/mcpCredentials — Stored in
~/.claude/secrets.vaultvia node-vault-mcp (AES-256-GCM)
Usage
List projects
list_projects:
limit: 25List repositories
list_repositories:
project: PROJReview a pull request
get_pull_request:
project: PROJ
repository: my-repo
prId: 123Search for a file
search:
query: README.md
type: file
project: PROJRead-Only Mode
Set BITBUCKET_READ_ONLY=true to block write operations. Read-only mode allows safe browsing and review without modifying repositories.
Development
npm run build
npm test
npm run lintSecurity
Please report security issues privately. See SECURITY.md for guidance.
License
MIT. See LICENSE.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Manage repositories, users, releases, and automate GitHub workflows
Connect to Atlassian Jira, Confluence, Loom, and more to search, create, and manage your work.
Access the GitHub API, enabling file operations, repository management, search functionality, and…
Security scanning for code, containers and IaC: request scans, read findings, report fixes.
Related MCP Servers
- AlicenseBqualityDmaintenanceEnables interaction with Bitbucket Cloud through 25+ tools for managing repositories, pull requests, branches, commits, issues, pipelines, and code search with OAuth 2.0 authentication.3426 npm1MIT
- AlicenseNot gradedqualityCmaintenanceEnables interaction with Bitbucket repositories through the Model Context Protocol, supporting code search, repository management, branch creation, pull requests, and more.1MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI systems to interact with Atlassian Bitbucket Server/Data Center for accessing projects, repositories, branches, files, and managing pull requests.MIT
- AlicenseAqualityCmaintenanceEnables retrieval of pull request metadata and diffs from Bitbucket Cloud and Server/Data Center, with optional comment creation.31MIT