MCP Bitbucket Pipelines

🚀 モデルコンテキストプロトコル（MCP）とBitbucket Pipelineの統合サーバー

本プロジェクトは、Model Context Protocol（MCP）プロトコルを基に、Bitbucket Pipelineとの統合サーバーを実装しています。MCPプロトコルを通じて、言語モデルは統一された標準インターフェースでBitbucket Pipelineとのやり取りを実現できます。

🚀 クイックスタート

📦 インストール

1. リポジトリをクローンします。
2. プロジェクトディレクトリに移動し、依存関係をインストールします。

   npm install
   

▶️ サーバーの起動

npm start

💻 使用例

基本的な使用法

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);

✨ 主な機能

• MCPプロトコルサポート：MCPプロトコルのサーバー側を実装し、標準入出力を通じた通信をサポートします。
• Bitbucket Pipeline統合：Bitbucket Pipelineシステムとのやり取りを行う機能モジュールを提供します。
• ツール化設計：すべての機能はMCP標準ツールの形式で実装されており、拡張と保守が容易です。

📁 プロジェクト構造

.
├── src/
│   ├── index.ts                # サーバーのエントリーファイル
│   └── tools/
│       └── bitbucket-pipelines.ts  # Bitbucket Pipeline関連の機能実装
├── package.json               # 依存関係管理とスクリプト設定
└── tsconfig.json              # TypeScriptのコンパイル設定

📚 ドキュメント

🔌 接続の初期化

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

🛠️ 利用可能なツールの一覧表示

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

🛠️ 特定のツールの呼び出し

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

🤝 貢献ガイド

1. プロジェクトリポジトリをForkします。
2. 機能ブランチを作成します（git checkout -b feature/nova-feature）。
3. 変更をコミットします（git commit -am '新機能の追加'）。
4. ブランチをリモートリポジトリにプッシュします（git push origin feature/nova-feature）。
5. Pull Requestを作成します。

🧑‍💻 プロジェクトメンテナ

• [your_name]