Merge pull request #37 from devsapp/add-devops

fix: add aliyun-devops mcp servers

Author: lowkeyrd

start-mcp-aliyun-devops/hook/index.js

@@ -0,0 +1,12 @@
+async function preInit(inputObj) {
+
+}
+
+async function postInit(inputObj) {
+
+}
+
+module.exports = {
+    postInit,
+    preInit
+}

start-mcp-aliyun-devops/publish.yaml

@@ -0,0 +1,38 @@
+Edition: 3.0.0
+Type: Project
+Name: aliyun-devops-mcp-server
+Version: 0.0.1
+Provider:
+  - 阿里云 # 取值内容参考：https://api.devsapp.cn/v3/common/args.html
+Description: 阿里云云效 MCP 服务
+HomePage: https://github.com/devsapp/fcai-mcp-servers/tree/main/start-mcp-aliyun-devops
+Tags: #标签详情
+  - MCP
+  - Node.js
+  - AliyunMCP
+Category: MCP服务 # 取值内容参考：https://api.devsapp.cn/v3/common/args.html
+Service: # 使用的服务
+  函数计算: # 取值内容参考：https://api.devsapp.cn/v3/common/args.html
+    Authorities: #权限描述
+      - AliyunFCFullAccess # 所需要的权限，例如AliyunFCFullAccess
+Organization: 阿里云函数计算（FC） # 所属组织
+Effective: Public # 是否公开，取值：Public，Private，Organization
+Parameters:
+  type: object
+  additionalProperties: false # 不允许增加其他属性
+  required: # 必填项
+    - region
+    - serviceRole
+  properties:
+    region:
+      title: 地域
+      type: string
+      default: cn-hangzhou
+      description: 创建应用所在的地区
+      enum:
+        - cn-beijing
+        - cn-hangzhou
+        - cn-shanghai
+        - cn-shenzhen
+        - ap-southeast-1
+    

start-mcp-aliyun-devops/readme.md

@@ -0,0 +1,229 @@
+
+> 注：当前项目为 Serverless Devs 应用，由于应用中会存在需要初始化才可运行的变量（例如应用部署地区、函数名等等），所以**不推荐**直接 Clone 本仓库到本地进行部署或直接复制 s.yaml 使用，**强烈推荐**通过 `s init ${模版名称}` 的方法或应用中心进行初始化，详情可参考[部署 & 体验](#部署--体验) 。
+
+# aliyun-devops-mcp-server 帮助文档
+
+<description>
+
+devops mcp server
+
+</description>
+
+
+## 资源准备
+
+使用该项目，您需要有开通以下服务并拥有对应权限：
+
+<service>
+
+
+
+| 服务/业务 |  权限  | 相关文档 |
+| --- |  --- | --- |
+| 函数计算 |  AliyunFCFullAccess | [帮助文档](https://help.aliyun.com/product/2508973.html) [计费文档](https://help.aliyun.com/document_detail/2512928.html) |
+
+</service>
+
+<remark>
+
+
+
+</remark>
+
+<disclaimers>
+
+
+
+</disclaimers>
+
+## 部署 & 体验
+
+<appcenter>
+   
+- :fire: 通过 [云原生应用开发平台 CAP](https://cap.console.aliyun.com/template-detail?template=aliyun-devops-mcp-server) ，[![Deploy with Severless Devs](https://img.alicdn.com/imgextra/i1/O1CN01w5RFbX1v45s8TIXPz_!!6000000006118-55-tps-95-28.svg)](https://cap.console.aliyun.com/template-detail?template=aliyun-devops-mcp-server) 该应用。
+   
+</appcenter>
+<deploy>
+    
+   
+</deploy>
+
+## 案例介绍
+
+<appdetail id="flushContent">
+
+## alibabacloud-devops-mcp-server
+[![smithery badge](https://smithery.ai/badge/@aliyun/alibabacloud-devops-mcp-server)](https://smithery.ai/server/@aliyun/alibabacloud-devops-mcp-server)
+
+[AlibabaCloud Devops](https://www.aliyun.com/product/yunxiao) MCP Server provides AI assistants with the ability to interact with the Yunxiao platform, enabling them to read work item contents in projects, automatically write code after understanding requirements, and submit code merge requests. Enterprise development teams can use it to assist with code reviews, optimize task management, reduce repetitive operations, and thus focus on more important innovation and product delivery.
+
+### Features
+
+alibabacloud-devops-mcp-server provides the following capabilities for AI assistants:
+
+* **Code Repository Management**: Query code repositories and their branches, create branches
+* **File Operations**: Create, update, delete, and retrieve code file content
+* **Code Review**: Create and manage code review processes
+* **Project Management**: Search projects, get project details
+* **Pipeline Management**: Get pipeline details, get pipeline list, create a pipeline run instance, get the latest pipeline run instance, get pipeline run details, get pipeline run list, Query / Run a pipeline deployment task
+* **Package Management**: Get package repository details list, Get artifacts details list, Get single artifact details
+
+### Tools
+
+alibabacloud-devops-mcp-server integrates various tools, including:
+
+#### Organization
+- `get_current_organization_Info`: Get current user's organization information
+- `get_user_organizations`: Get the list of organizations the current user has joined
+
+#### Code Management Tools
+
+- `create_branch`: Create a branch
+- `delete_branch`: Delete a branch
+- `get_branch`: Get branch information
+- `list_branches`: Get branch list
+- `create_file`: Create a file
+- `delete_file`: Delete a file
+- `get_file_blobs`: Get file content
+- `list_files`: Query file tree
+- `update_file`: Update file content
+- `create_change_request`: Create a merge request
+- `create_change_request_comment`: Create a comment on a merge request
+- `get_change_request`: Query merge request
+- `list_change_request_patch_sets`: Query merge request version list
+- `list_change_request`: Query merge request list
+- `list_change_request_comments`: Query merge request comment list
+- `get_compare`: Compare code
+- `get_repository`: Get repository details
+- `list_repositories`: Get repository list
+
+#### Project Management Tools
+
+- `get_project`: Get project details
+- `search_projects`: Search projects
+- `get_work_item`: Get work item details
+- `search_workitems`: Search work items
+
+#### Pipeline Management Tools
+
+- `get_pipeline`: Get pipeline details
+- `list_pipelines`: Get pipeline list
+- `smart_list_pipelines`: Smart pipeline search with natural language time references
+- `create_pipeline_run`: Create a pipeline run instance
+- `get_latest_pipeline_run`: Get the latest pipeline run instance
+- `get_pipeline_run`: Get pipeline run details
+- `list_pipeline_runs`: Get pipeline run list
+- `list_pipeline_jobs_by_category`: Get pipeline execution tasks by category
+- `list_pipeline_job_historys`: Get the execution history of a pipeline task
+- `execute_pipeline_job_run`: Manually run a pipeline task
+- `get_pipeline_job_run_log`: Get the execution logs of a pipeline job
+- `list_service_connections`: List service connections in organization
+- `generate_pipeline_yaml`:   Automatically generates YAML configuration
+- `create_pipeline_from_description`: Automatically generates YAML configuration and creates pipeline
+
+#### Packages Management Tools
+
+- `list_package_repositories`: Get package repositories details list
+- `list_artifacts`: Get artifacts details list
+- `get_artifact`: Get single artifact details
+
+### Usage
+
+#### Prerequisites
+* node version >= 16.0.0
+* [AlibabaCloud Devops](https://www.aliyun.com/product/yunxiao) Personal Access Token, [click here to obtain](https://help.aliyun.com/zh/yunxiao/developer-reference/obtain-personal-access-token). Grant read and write permissions to all APIs under organization management, project collaboration, code management, pipeline management, artifact repository management, application delivery and testing management.
+
+  ![The personal token authorization page](https://agent-install-beijing.oss-cn-beijing.aliyuncs.com/alibabacloud-devops-mcp-server/img_8.jpg)
+
+#### Installing via Smithery
+
+To install [AlibabaCloud DevOps](https://www.aliyun.com/product/yunxiao) Server for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@aliyun/alibabacloud-devops-mcp-server):
+
+```bash
+npx -y @smithery/cli install @aliyun/alibabacloud-devops-mcp-server --client claude
+```
+
+#### Install Yunxiao MCP server via MCP marketplace
+The MCP market built into Lingma (AlibabaCloud Tongyi Lingma) has already provided the AlibabaCloud Devops MCP service. To install it, simply enter the MCP market in Lingma and search for "Yunxiao DevOps", then click install.
+
+![Install AlibabaCloud Devops MCP Service from the MCP Market](https://agent-install-beijing.oss-cn-beijing.aliyuncs.com/alibabacloud-devops-mcp-server/img_9.png)
+
+#### Run MCP Server via NPX
+```json
+{
+  "mcpServers": {
+    "yunxiao": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "alibabacloud-devops-mcp-server"
+      ],
+      "env": {
+        "YUNXIAO_ACCESS_TOKEN": "<YOUR_TOKEN>"
+      }
+    }
+  }
+}
+```
+
+#### Run MCP Server via Docker Container
+1. Docker build
+```shell
+docker build -t alibabacloud/alibabacloud-devops-mcp-server .
+```
+2. Configure MCP Server
+```json
+{
+  "mcpServers": {
+    "yunxiao": {
+      "command": "docker",
+      "args": [
+        "run",
+        "-i",
+        "--rm",
+        "-e",
+        "YUNXIAO_ACCESS_TOKEN",
+        "alibabacloud/alibabacloud-devops-mcp-server"
+      ],
+      "env": {
+        "YUNXIAO_ACCESS_TOKEN": "<YOUR_TOKEN>"
+      }
+    }
+  }
+}
+```
+
+### Related Links
+- [AlibabaCloud DevOps](https://www.aliyun.com/product/yunxiao)
+- [MCP market](https://modelscope.cn/mcp/servers/@aliyun/alibabacloud-devops-mcp-server)
+- [Example Use Cases](https://mp.weixin.qq.com/s/KQsN6dQlnNeCNATC-QD7pg)
+
+
+</appdetail>
+
+
+
+
+
+
+
+## 使用流程
+
+<usedetail id="flushContent">
+
+### 步骤一   
+通过[FunctionAI MCP市场](https://cap.console.aliyun.com/mcp/274) 部署完成后，在集成向导中复制MCP Client的连接配置，准备好支持 SSE 的 MCP Client，通过 SSETransport 进行连接。
+
+<img src="https://img.alicdn.com/imgextra/i4/O1CN01vbDOML1LI02jGV936_!!6000000001275-2-tps-1888-1446.png" alt="MCP Client" width="80%">
+
+
+</usedetail>
+
+
+
+
+
+
+
+
+

start-mcp-aliyun-devops/src/build.yaml

@@ -0,0 +1,11 @@
+aliyun-devops-mcp-server:
+  default:
+    rootPath: ./code
+    languages:
+      - nodejs20
+    cache:
+      paths:
+        - "~/.npm"
+    steps:
+      - run: npm install
+      - run: npm run build

start-mcp-aliyun-devops/src/code/.gitignore

@@ -0,0 +1,6 @@
+node_modules
+dist
+*.log
+.env
+.idea
+.vscode

start-mcp-aliyun-devops/src/code/Dockerfile

@@ -0,0 +1,30 @@
+# Generated by https://smithery.ai. See: https://smithery.ai/docs/build/project-config
+FROM node:22.12-alpine AS builder
+
+# 复制项目文件
+COPY . /app
+COPY tsconfig.json /tsconfig.json
+
+WORKDIR /app
+
+# 安装依赖并构建
+RUN --mount=type=cache,target=/root/.npm npm install
+
+# 添加构建步骤以生成 dist 目录
+RUN npm run build
+
+FROM node:22.12-alpine AS release
+
+# 从构建阶段复制必要文件
+COPY --from=builder /app/dist /app/dist
+COPY --from=builder /app/package.json /app/package.json
+COPY --from=builder /app/package-lock.json /app/package-lock.json
+
+ENV NODE_ENV=production
+
+WORKDIR /app
+
+# 安装生产依赖
+RUN npm ci --ignore-scripts --omit=dev
+
+ENTRYPOINT ["node", "dist/index.js"]