@cnbcool/mcp-server 0.2.0-beta.0 → 0.3.0-beta.1

package/dist/api/client.js

@@ -0,0 +1,42 @@
+export default class CnbApiClient {
+    static instance = null;
+    _baseUrl;
+    _token;
+    constructor(options) {
+        this._baseUrl = options.baseUrl;
+        this._token = options.token;
+    }
+    get baseUrl() {
+        return this._baseUrl;
+    }
+    static initialize(options) {
+        if (!CnbApiClient.instance) {
+            CnbApiClient.instance = new CnbApiClient(options);
+        }
+    }
+    static getInstance() {
+        if (!CnbApiClient.instance) {
+            throw new Error('CnbApiClient not initialized. Call CnbApiClient.initialize(baseUrl, token) first.');
+        }
+        return CnbApiClient.instance;
+    }
+    async request(method, path, body, config) {
+        const url = `${this._baseUrl}${path}`;
+        const headers = {
+            Authorization: `Bearer ${this._token}`,
+            Accept: 'application/vnd.cnb.api+json',
+            ...(config?.header || {})
+        };
+        const options = {
+            method,
+            headers,
+            body: body ? JSON.stringify(body) : undefined
+        };
+        const response = await fetch(url, options);
+        if (!response.ok) {
+            const errorText = await response.text();
+            throw new Error(`API request failed: ${response.status} ${errorText}`);
+        }
+        return response.json();
+    }
+}

package/dist/api/issue.js

@@ -0,0 +1,27 @@
+import CnbApiClient from './client.js';
+export async function listIssues(repo, params) {
+    const cnbInst = CnbApiClient.getInstance();
+    const url = new URL(`/${repo}/-/issues`, cnbInst.baseUrl);
+    if (params) {
+        for (const [key, value] of Object.entries(params)) {
+            if (value === undefined)
+                continue;
+            url.searchParams.set(key, value.toString());
+        }
+    }
+    return cnbInst.request('GET', `${url.pathname}${url.search}`);
+}
+export async function getIssue(repo, issueId) {
+    return CnbApiClient.getInstance().request('GET', `/${repo}/-/issues/${issueId}`);
+}
+export async function createIssue(repo, params) {
+    const newParams = Object.entries(params).reduce((acc, [key, value]) => {
+        if (value === undefined)
+            return acc;
+        Object.assign(acc, { [key]: value });
+        return acc;
+    }, {});
+    return CnbApiClient.getInstance().request('POST', `/${repo}/-/issues`, newParams, {
+        header: { 'Content-Type': 'application/json' }
+    });
+}

package/dist/api/repository.js

@@ -0,0 +1,28 @@
+import CnbApiClient from './client.js';
+export async function listRepositories(params) {
+    const cnbInst = CnbApiClient.getInstance();
+    const url = new URL('/user/repos', cnbInst.baseUrl);
+    if (params) {
+        for (const [key, value] of Object.entries(params)) {
+            if (value === undefined)
+                continue;
+            url.searchParams.set(key, value.toString());
+        }
+    }
+    return cnbInst.request('GET', `${url.pathname}${url.search}`);
+}
+export async function listGroupRepositories(group, params) {
+    const cnbInst = CnbApiClient.getInstance();
+    const url = new URL(`/${group}/-/repos`, cnbInst.baseUrl);
+    if (params) {
+        for (const [key, value] of Object.entries(params)) {
+            if (value === undefined)
+                continue;
+            url.searchParams.set(key, value.toString());
+        }
+    }
+    return cnbInst.request('GET', `${url.pathname}${url.search}`);
+}
+export async function getRepository(repo) {
+    return CnbApiClient.getInstance().request('GET', `/${repo}`);
+}

package/dist/api/workspace.js

@@ -0,0 +1,20 @@
+import CnbApiClient from './client.js';
+export async function listWorkspace(params) {
+    const cnbInst = CnbApiClient.getInstance();
+    const url = new URL('/workspace/list', cnbInst.baseUrl);
+    if (params) {
+        for (const [key, value] of Object.entries(params)) {
+            if (value === undefined)
+                continue;
+            url.searchParams.set(key, value.toString());
+        }
+    }
+    return cnbInst.request('GET', `${url.pathname}${url.search}`);
+}
+export async function deleteWorkspace(params) {
+    const cnbInst = CnbApiClient.getInstance();
+    const url = new URL('/workspace/delete', cnbInst.baseUrl);
+    return cnbInst.request('POST', `${url.pathname}`, params, {
+        header: { 'Content-Type': 'application/json' }
+    });
+}

package/dist/index.js

@@ -1,28 +1,23 @@
 #!/usr/bin/env node
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import dotenv from "dotenv";
-import { CnbApiClient } from "./CnbApiClient.js";
-import { registerTools } from "./tools/index.js";
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import dotenv from 'dotenv';
+import { registerTools } from './tools/index.js';
 // https://www.typescriptlang.org/docs/handbook/release-notes/typescript-5-3.html#import-attributes
-import packageJSON from "../package.json" with { type: 'json' };
+import packageJSON from '../package.json' with { type: 'json' };
 dotenv.config();
-const cnbApiClient = new CnbApiClient({
-    baseUrl: process.env.API_BASE_URL || "https://api.cnb.cool",
-    token: process.env.API_TOKEN || ""
-});
 const server = new McpServer({
-    name: "cnb-mcp-server",
+    name: 'cnb-mcp-server',
     version: packageJSON.version
 });
-registerTools(server, cnbApiClient);
+registerTools(server);
 async function main() {
-    console.error("server starting...");
+    console.error('server starting...');
     const transport = new StdioServerTransport();
     await server.connect(transport);
-    console.error("server connected");
+    console.error('server connected');
 }
-main().catch(error => {
-    console.error("Fatal error:", error);
+main().catch((error) => {
+    console.error('Fatal error:', error);
     process.exit(1);
 });

package/dist/tools/index.js

@@ -1,6 +1,13 @@
-import registerRepoTools from "./repoTools.js";
-import registerIssueTools from "./issueTools.js";
-export function registerTools(server, cnbApi) {
-    registerRepoTools(server, cnbApi);
-    registerIssueTools(server, cnbApi);
+import CnbApiClient from '../api/client.js';
+import registerRepoTools from './repoTools.js';
+import registerIssueTools from './issueTools.js';
+import registerWorkspaceTools from './workspaceTools.js';
+export function registerTools(server) {
+    CnbApiClient.initialize({
+        baseUrl: process.env.API_BASE_URL || 'https://api.cnb.cool',
+        token: process.env.API_TOKEN || ''
+    });
+    registerRepoTools(server);
+    registerIssueTools(server);
+    registerWorkspaceTools(server);
 }

package/dist/tools/issueTools.js

@@ -1,71 +1,92 @@
-import { z } from "zod";
-export default function registerIssueTools(server, cnbApi) {
-    server.tool("list-issues", "查询仓库的 Issues", {
-        repoId: z.string().describe("仓库 ID"),
-        page: z.number().optional().describe("第几页，从1开始"),
-        page_size: z.number().optional().describe("每页多少条数据"),
-        state: z.enum(["open", "closed"]).optional().describe("Issue 状态"),
-        keyword: z.string().optional().describe("Issue 关键字"),
-        priority: z.string().optional().describe("Issue 优先级"),
-        labels: z.string().optional().describe("Issue 标签"),
-        authors: z.string().optional().describe("Issue 作者的名字"),
-        assignees: z.string().optional().describe("Issue 处理人"),
-        updated_time_begin: z.string().optional().describe("Issue 更新时间的范围，开始时间点"),
-        updated_time_end: z.string().optional().describe("Issue 更新时间的范围，结束时间点"),
-        order_by: z.string().optional().describe("Issue 排序顺序"),
+import { z } from 'zod';
+import { createIssue, getIssue, listIssues } from '../api/issue.js';
+export default function registerIssueTools(server) {
+    server.tool('list-issues', '查询仓库的 Issues', {
+        repoId: z.string().describe('仓库 ID'),
+        page: z.number().optional().describe('第几页，从1开始'),
+        page_size: z.number().optional().describe('每页多少条数据'),
+        state: z.enum(['open', 'closed']).optional().describe('Issue 状态'),
+        keyword: z.string().optional().describe('Issue 关键字'),
+        priority: z.string().optional().describe('Issue 优先级'),
+        labels: z.string().optional().describe('Issue 标签'),
+        authors: z.string().optional().describe('Issue 作者的名字'),
+        assignees: z.string().optional().describe('Issue 处理人'),
+        updated_time_begin: z.string().optional().describe('Issue 更新时间的范围，开始时间点'),
+        updated_time_end: z.string().optional().describe('Issue 更新时间的范围，结束时间点'),
+        order_by: z.string().optional().describe('Issue 排序顺序')
     }, async ({ repoId, page, page_size, state, keyword, priority, labels, authors, assignees, updated_time_begin, updated_time_end, order_by }) => {
         try {
-            const issues = await cnbApi.listIssues(repoId, { page, page_size, state, keyword, priority, labels, authors, assignees, updated_time_begin, updated_time_end, order_by });
+            const issues = await listIssues(repoId, {
+                page,
+                page_size,
+                state,
+                keyword,
+                priority,
+                labels,
+                authors,
+                assignees,
+                updated_time_begin,
+                updated_time_end,
+                order_by
+            });
             return {
-                content: [{
-                        type: "text",
+                content: [
+                    {
+                        type: 'text',
                         text: JSON.stringify(issues, null, 2)
-                    }]
+                    }
+                ]
             };
         }
         catch (error) {
             return {
-                content: [{
-                        type: "text",
+                content: [
+                    {
+                        type: 'text',
                         text: `Error listing issues: ${error instanceof Error ? error.message : String(error)}`
-                    }],
+                    }
+                ],
                 isError: true
             };
         }
     });
-    server.tool("get-issue", "获取指定 Issue 信息", {
-        repoId: z.string().describe("仓库 ID"),
-        issueId: z.number().describe("Issue ID")
+    server.tool('get-issue', '获取指定 Issue 信息', {
+        repoId: z.string().describe('仓库 ID'),
+        issueId: z.number().describe('Issue ID')
     }, async ({ repoId, issueId }) => {
         try {
-            const issues = await cnbApi.getIssue(repoId, issueId);
+            const issues = await getIssue(repoId, issueId);
             return {
-                content: [{
-                        type: "text",
+                content: [
+                    {
+                        type: 'text',
                         text: JSON.stringify(issues, null, 2)
-                    }]
+                    }
+                ]
             };
         }
         catch (error) {
             return {
-                content: [{
-                        type: "text",
+                content: [
+                    {
+                        type: 'text',
                         text: `Error listing issues: ${error instanceof Error ? error.message : String(error)}`
-                    }],
+                    }
+                ],
                 isError: true
             };
         }
     });
-    server.tool("create-issue", "创建一个 Issue", {
-        repoId: z.string().describe("仓库 ID"),
-        title: z.string().describe("Issue 标题"),
-        body: z.string().optional().describe("Issue 描述"),
-        assignees: z.array(z.string()).optional().describe("一个或多个 Issue 处理人的用户名"),
-        labels: z.array(z.string()).optional().describe("一个或多个 Issue 标签"),
-        priority: z.string().optional().describe("Issue 优先级")
+    server.tool('create-issue', '创建一个 Issue', {
+        repoId: z.string().describe('仓库 ID'),
+        title: z.string().describe('Issue 标题'),
+        body: z.string().optional().describe('Issue 描述'),
+        assignees: z.array(z.string()).optional().describe('一个或多个 Issue 处理人的用户名'),
+        labels: z.array(z.string()).optional().describe('一个或多个 Issue 标签'),
+        priority: z.string().optional().describe('Issue 优先级')
     }, async ({ repoId, title, body, assignees, labels, priority }) => {
         try {
-            const issue = await cnbApi.createIssue(repoId, {
+            const issue = await createIssue(repoId, {
                 title,
                 body,
                 assignees,
@@ -73,18 +94,22 @@ export default function registerIssueTools(server, cnbApi) {
                 priority
             });
             return {
-                content: [{
-                        type: "text",
+                content: [
+                    {
+                        type: 'text',
                         text: `Issue created successfully:\n${JSON.stringify(issue, null, 2)}`
-                    }]
+                    }
+                ]
             };
         }
         catch (error) {
             return {
-                content: [{
-                        type: "text",
+                content: [
+                    {
+                        type: 'text',
                         text: `Error creating issue: ${error instanceof Error ? error.message : String(error)}`
-                    }],
+                    }
+                ],
                 isError: true
             };
         }

package/dist/tools/repoTools.js

@@ -1,80 +1,101 @@
-import { z } from "zod";
-export default function registerRepoTools(server, cnbApi) {
-    server.tool("list-repositories", "获取当前用户拥有指定权限及其以上权限的仓库", {
-        page: z.number().default(1).describe("第几页，从1开始"),
-        page_size: z.number().default(20).describe("每页多少条数据"),
-        search: z.string().optional().describe("仓库关键字"),
-        filter_type: z.enum(["private", "public", "encrypted"]).optional().describe("仓库类型"),
-        role: z.enum(["Reporter", "Developer", "Master", "Owner"]).optional().describe("最小仓库权限"),
-        order_by: z.enum(["created_at", "last_updated_at", "stars"]).optional().describe("排序类型"),
-        desc: z.boolean().optional().describe("排序顺序")
+import { z } from 'zod';
+import { getRepository, listGroupRepositories, listRepositories } from '../api/repository.js';
+export default function registerRepoTools(server) {
+    server.tool('list-repositories', '获取当前用户拥有指定权限及其以上权限的仓库', {
+        page: z.number().default(1).describe('第几页，从1开始'),
+        page_size: z.number().default(20).describe('每页多少条数据'),
+        search: z.string().optional().describe('仓库关键字'),
+        filter_type: z.enum(['private', 'public', 'encrypted']).optional().describe('仓库类型'),
+        role: z.enum(['Reporter', 'Developer', 'Master', 'Owner']).optional().describe('最小仓库权限'),
+        order_by: z.enum(['created_at', 'last_updated_at', 'stars']).optional().describe('排序类型'),
+        desc: z.boolean().optional().describe('排序顺序')
     }, async ({ page, page_size, search, filter_type, role, order_by, desc }) => {
         try {
-            const repos = await cnbApi.listRepositories({ page, page_size, search, filter_type, role, order_by, desc });
+            const repos = await listRepositories({ page, page_size, search, filter_type, role, order_by, desc });
             return {
-                content: [{
-                        type: "text",
+                content: [
+                    {
+                        type: 'text',
                         text: JSON.stringify(repos, null, 2)
-                    }]
+                    }
+                ]
             };
         }
         catch (error) {
             return {
-                content: [{
-                        type: "text",
+                content: [
+                    {
+                        type: 'text',
                         text: `Error listing repositories: ${error instanceof Error ? error.message : String(error)}`
-                    }],
+                    }
+                ],
                 isError: true
             };
         }
     });
-    server.tool("list-group-repositories", "获取分组里当前用户有权限的仓库", {
-        group: z.string().describe("组织名称"),
-        page: z.number().default(1).describe("第几页，从1开始"),
-        page_size: z.number().default(20).describe("每页多少条数据"),
-        search: z.string().optional().describe("仓库关键字"),
-        filter_type: z.enum(["private", "public", "encrypted"]).optional().describe("仓库类型"),
-        descendant: z.enum(["all", "sub", "grand"]).optional().describe("查全部、直接属于当前组织的仓库、子组织的仓库"),
-        order_by: z.enum(["created_at", "last_updated_at", "stars", "slug_path"]).optional().describe("排序类型"),
-        desc: z.boolean().optional().describe("排序顺序")
+    server.tool('list-group-repositories', '获取分组里当前用户有权限的仓库', {
+        group: z.string().describe('组织名称'),
+        page: z.number().default(1).describe('第几页，从1开始'),
+        page_size: z.number().default(20).describe('每页多少条数据'),
+        search: z.string().optional().describe('仓库关键字'),
+        filter_type: z.enum(['private', 'public', 'encrypted']).optional().describe('仓库类型'),
+        descendant: z.enum(['all', 'sub', 'grand']).optional().describe('查全部、直接属于当前组织的仓库、子组织的仓库'),
+        order_by: z.enum(['created_at', 'last_updated_at', 'stars', 'slug_path']).optional().describe('排序类型'),
+        desc: z.boolean().optional().describe('排序顺序')
     }, async ({ group, page, page_size, search, filter_type, descendant, order_by, desc }) => {
         try {
-            const repos = await cnbApi.listGroupRepositories(group, { page, page_size, search, filter_type, descendant, order_by, desc });
+            const repos = await listGroupRepositories(group, {
+                page,
+                page_size,
+                search,
+                filter_type,
+                descendant,
+                order_by,
+                desc
+            });
             return {
-                content: [{
-                        type: "text",
+                content: [
+                    {
+                        type: 'text',
                         text: JSON.stringify(repos, null, 2)
-                    }]
+                    }
+                ]
             };
         }
         catch (error) {
             return {
-                content: [{
-                        type: "text",
+                content: [
+                    {
+                        type: 'text',
                         text: `Error listing repositories: ${error instanceof Error ? error.message : String(error)}`
-                    }],
+                    }
+                ],
                 isError: true
             };
         }
     });
-    server.tool("get-repository", "获取指定仓库信息", {
-        repoId: z.string().describe("仓库 ID")
+    server.tool('get-repository', '获取指定仓库信息', {
+        repoId: z.string().describe('仓库 ID')
     }, async ({ repoId }) => {
         try {
-            const repo = await cnbApi.getRepository(repoId);
+            const repo = await getRepository(repoId);
             return {
-                content: [{
-                        type: "text",
+                content: [
+                    {
+                        type: 'text',
                         text: JSON.stringify(repo, null, 2)
-                    }]
+                    }
+                ]
             };
         }
         catch (error) {
             return {
-                content: [{
-                        type: "text",
+                content: [
+                    {
+                        type: 'text',
                         text: `Error getting repository: ${error instanceof Error ? error.message : String(error)}`
-                    }],
+                    }
+                ],
                 isError: true
             };
         }

package/dist/tools/workspaceTools.js

@@ -0,0 +1,87 @@
+import { z } from 'zod';
+import { deleteWorkspace, listWorkspace } from '../api/workspace.js';
+export default function registerWorkspaceTools(server) {
+    server.tool('list-workspace', '获取我的云原生开发环境列表', {
+        branch: z.string().optional().describe('分支名，例如：main'),
+        start: z
+            .string()
+            .optional()
+            .describe('查询结束时间，格式：YYYY-MM-DD HH:mm:ssZZ，例如：2024-12-01 00:00:00+0800'),
+        end: z.string().optional().describe('查询开始时间，格式：YYYY-MM-DD HH:mm:ssZZ，例如：2024-12-01 00:00:00+0800'),
+        page: z.number().optional().describe('分页页码，从 1 开始，默认为 1'),
+        pageSize: z.number().optional().describe('每页条数，默认为 20，最高 100'),
+        slug: z.string().optional().describe('仓库路径，例如：groupname/reponame'),
+        status: z
+            .enum(['running', 'closed'])
+            .optional()
+            .describe('开发环境状态，running: 开发环境已启动，closed：开发环境已关闭，默认为所有状态')
+    }, async ({ branch, page, pageSize, start, end, slug, status }) => {
+        console.log('list-workspace', {
+            branch,
+            page,
+            pageSize,
+            start,
+            end,
+            slug,
+            status
+        });
+        try {
+            const workspaces = await listWorkspace({
+                branch,
+                page,
+                pageSize,
+                start,
+                end,
+                slug,
+                status
+            });
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify(workspaces, null, 2)
+                    }
+                ]
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error listing workspace: ${error instanceof Error ? error.message : String(error)}`
+                    }
+                ],
+                isError: true
+            };
+        }
+    });
+    server.tool('delete-workspace', '删除我的云原生开发环境', {
+        pipelineId: z.string().describe('开发环境 ID')
+    }, async ({ pipelineId }) => {
+        try {
+            const result = await deleteWorkspace({
+                pipelineId
+            });
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify(result, null, 2)
+                    }
+                ]
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `error delete workspace: ${error instanceof Error ? error.message : String(error)}`
+                    }
+                ],
+                isError: true
+            };
+        }
+    });
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@cnbcool/mcp-server",
   "description": "CNB MCP Server. A comprehensive MCP server that provides seamless integration to the CNB's API(https://cnb.cool), offering a wide range of tools for repository management, pipelines operations and collaboration features",
-  "version": "0.2.0-beta.0",
+  "version": "0.3.0-beta.1",
   "main": "./dist/index.js",
   "bin": {
     "cnb-mcp-server": "dist/index.js"

package/dist/CnbApiClient.js

@@ -1,76 +0,0 @@
-export class CnbApiClient {
-    baseUrl;
-    token;
-    constructor(options) {
-        this.baseUrl = options.baseUrl;
-        this.token = options.token;
-    }
-    async request(method, path, body, config) {
-        const url = `${this.baseUrl}${path}`;
-        const headers = {
-            'Authorization': `Bearer ${this.token}`,
-            'Accept': 'application/vnd.cnb.api+json',
-            ...(config?.header || {})
-        };
-        const options = {
-            method,
-            headers,
-            body: body ? JSON.stringify(body) : undefined
-        };
-        const response = await fetch(url, options);
-        if (!response.ok) {
-            const errorText = await response.text();
-            throw new Error(`API request failed: ${response.status} ${errorText}`);
-        }
-        return response.json();
-    }
-    async listRepositories(params) {
-        const url = new URL('/user/repos', this.baseUrl);
-        if (params) {
-            for (const [key, value] of Object.entries(params)) {
-                if (value === undefined)
-                    continue;
-                url.searchParams.set(key, value.toString());
-            }
-        }
-        return this.request('GET', `${url.pathname}${url.search}`);
-    }
-    async listGroupRepositories(group, params) {
-        const url = new URL(`/${group}/-/repos`, this.baseUrl);
-        if (params) {
-            for (const [key, value] of Object.entries(params)) {
-                if (value === undefined)
-                    continue;
-                url.searchParams.set(key, value.toString());
-            }
-        }
-        return this.request('GET', `${url.pathname}${url.search}`);
-    }
-    async getRepository(repo) {
-        return this.request('GET', `/${repo}`);
-    }
-    async listIssues(repo, params) {
-        const url = new URL(`/${repo}/-/issues`, this.baseUrl);
-        if (params) {
-            for (const [key, value] of Object.entries(params)) {
-                if (value === undefined)
-                    continue;
-                url.searchParams.set(key, value.toString());
-            }
-        }
-        return this.request('GET', `${url.pathname}${url.search}`);
-    }
-    async getIssue(repo, issueId) {
-        return this.request('GET', `/${repo}/-/issues/${issueId}`);
-    }
-    async createIssue(repo, params) {
-        const newParams = Object.entries(params).reduce((acc, [key, value]) => {
-            if (value === undefined)
-                return acc;
-            // @ts-ignore
-            acc[key] = value;
-            return acc;
-        }, {});
-        return this.request('POST', `/${repo}/-/issues`, newParams, { header: { 'Content-Type': 'application/json' } });
-    }
-}