MCP Bitbucket Pipelines

🚀 與 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 編譯配置

使用 MCP 協議

初始化連接

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]