
- Add search_code tool for searching code across Bitbucket repositories - Currently supports Bitbucket Server only (Cloud support planned) - Implement SearchHandlers class following modular architecture - Add formatCodeSearchOutput for clean AI-friendly output - Support file pattern filtering with glob patterns - Add comprehensive documentation and examples - Create Memory Bank for project documentation - Bump version to 1.0.0 indicating stable API with comprehensive features - Update CHANGELOG.md with v1.0.0 release notes
47 lines
1.7 KiB
YAML
47 lines
1.7 KiB
YAML
# Project Brief - Bitbucket MCP Server
|
|
|
|
project_name: "bitbucket-mcp-server"
|
|
version: "1.0.0"
|
|
description: "MCP (Model Context Protocol) server for Bitbucket API integration"
|
|
primary_purpose: "Provide tools for interacting with Bitbucket APIs via MCP"
|
|
|
|
key_features:
|
|
- "Support for both Bitbucket Cloud and Server"
|
|
- "19 comprehensive tools for PR management, branch operations, and code review"
|
|
- "Modular architecture with separate handlers for different tool categories"
|
|
- "Smart file content handling with automatic truncation"
|
|
- "Advanced PR commenting with code suggestions and snippet matching"
|
|
- "Code search functionality across repositories"
|
|
|
|
scope:
|
|
included:
|
|
- "Pull Request lifecycle management"
|
|
- "Branch management and operations"
|
|
- "Code review and approval workflows"
|
|
- "File and directory operations"
|
|
- "Code search (Bitbucket Server only)"
|
|
- "Authentication via app passwords/tokens"
|
|
|
|
excluded:
|
|
- "Repository creation/deletion"
|
|
- "User management"
|
|
- "Pipeline/build operations"
|
|
- "Wiki/documentation management"
|
|
- "Bitbucket Cloud code search (future enhancement)"
|
|
|
|
constraints:
|
|
technical:
|
|
- "Node.js >= 16.0.0 required"
|
|
- "TypeScript with ES modules"
|
|
- "MCP SDK for protocol implementation"
|
|
|
|
authentication:
|
|
- "Bitbucket Cloud: App passwords required"
|
|
- "Bitbucket Server: HTTP access tokens required"
|
|
- "Different username formats for Cloud vs Server"
|
|
|
|
success_criteria:
|
|
- "Seamless integration with MCP-compatible clients"
|
|
- "Reliable API interactions with proper error handling"
|
|
- "Consistent response formatting across tools"
|
|
- "Maintainable and extensible codebase"
|