MCP Bitbucket Pipelines

🚀 Integration Server for Bitbucket Pipeline based on MCP Protocol

This project implements an integration server with Bitbucket Pipeline based on the Model Context Protocol (MCP). Through the MCP, language models can interact with Bitbucket Pipeline using a unified standard interface.

🚀 Quick Start

📦 Installation

1. Clone the repository.
2. Navigate to the project directory and install dependencies:

npm install

▶️ Run the Server

npm start

💻 Usage Examples

Basic Usage

import { Client } from '@modelcontextprotocol/sdk/client';
import { ChildProcessTransport } from '@modelcontextprotocol/sdk/client/child-process';

async function main() {
  const client = new Client({
    transport: new ChildProcessTransport({
      command: 'node',
      args: ['dist/index.js'],
      env: {
        BITBUCKET_ACCESS_TOKEN: 'your_token',
        BITBUCKET_WORKSPACE: 'your_workspace', 
        BITBUCKET_REPO_SLUG: 'your_repository'
      }
    })
  });

  const tools = await client.listTools();
  console.log('Available tools:', tools);

  const pipelines = await client.callTool('mcp_bitbucket_list_pipelines', { page: 1, pagelen: 5 });
  console.log('Pipelines:', pipelines);

  await client.close();
}

main().catch(console.error);

✨ Features

• MCP Protocol Support: Implements the server - side of the MCP, supporting communication via standard input and output.
• Bitbucket Pipeline Integration: Provides functional modules for interacting with the Bitbucket Pipeline system.
• Tool - Oriented Design: All functions are implemented as MCP standard tools, facilitating expansion and maintenance.

📁 Project Structure

.
├── src/
│   ├── index.ts                # Server entry file
│   └── tools/
│       └── bitbucket-pipelines.ts  # Implementation of Bitbucket Pipeline related functions
├── package.json               # Dependency management and script configuration
└── tsconfig.json              # TypeScript compilation configuration

📚 Documentation

Using the MCP Protocol

Initialize the Connection

echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"name":"Test Client","version":"1.0.0","protocolVersion":"0.3.0","capabilities":{},"clientInfo":{"name":"Test Client","version":"1.0.0"}}}' | docker exec -i bitbucket-pipelines-mcp_mcp-server-1 node dist/index.js

List Available Tools

echo '{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}' | docker exec -i bitbucket-pipelines-mcp_mcp-server-1 node dist/index.js

Call a Specific Tool

echo '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"mcp_bitbucket_list_pipelines","input":{"page":1,"pagelen":5}}}' | docker exec -i bitbucket-pipelines-mcp_mcp-server-1 node dist/index.js

🤝 Contribution Guide

1. Fork the project repository.
2. Create a feature branch (git checkout -b feature/nova-feature).
3. Commit your changes (git commit -am 'Add new feature').
4. Push the branch to the remote repository (git push origin feature/nova-feature).
5. Create a Pull Request.

🧑‍💼 Project Maintainers

• [your_name]