@cnbcool/mcp-server 0.3.1 → 0.3.3

package/CHANGELOG.md

@@ -1,3 +1,27 @@
+## 0.3.3 (May 7, 2025)
+
+### Bug Fixes
+
+- Format repository creation response
+- Format group creation response
+
+## 0.3.2 (May 6, 2025)
+
+### New Features
+
+- Supports list groups with various filters
+- Supports list sub-groups with various filters
+- Supports get group details
+- Supports create group
+- Supports create repository
+
+## 0.3.1 (April 23, 2025)
+
+### New Features
+
+- Bump to @modelcontextprotocol/sdk 1.10.2
+- Add zod preprocess, convert null to undefined
+
 ## 0.3.0 (April 23, 2025)
 
 ### New Features

package/dist/api/client.js

@@ -20,7 +20,8 @@ export default class CnbApiClient {
         }
         return CnbApiClient.instance;
     }
-    async request(method, path, body, config) {
+    async request(method, path, body, config, responseType = 'json' // 'json' | 'text' | 'raw'
+    ) {
         const url = `${this._baseUrl}${path}`;
         const headers = {
             Authorization: `Bearer ${this._token}`,
@@ -37,6 +38,12 @@ export default class CnbApiClient {
             const errorText = await response.text();
             throw new Error(`API request failed: ${response.status} ${errorText}`);
         }
+        if (responseType === 'raw') {
+            return response;
+        }
+        if (responseType === 'text') {
+            return response.text();
+        }
         return response.json();
     }
 }

package/dist/api/group.js

@@ -0,0 +1,46 @@
+import CnbApiClient from './client.js';
+export async function listGroups(params) {
+    const cnbInst = CnbApiClient.getInstance();
+    const url = new URL('/user/groups', 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 listSubGroups(group, params) {
+    const cnbInst = CnbApiClient.getInstance();
+    const url = new URL(`/user/groups/${group}`, 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 getGroup(group) {
+    const cnbInst = CnbApiClient.getInstance();
+    return cnbInst.request('GET', `/${group}`);
+}
+export async function createGroup(params) {
+    const body = Object.entries(params).reduce((acc, [key, value]) => {
+        if (value === undefined)
+            return acc;
+        Object.assign(acc, { [key]: value });
+        return acc;
+    }, {});
+    const response = await CnbApiClient.getInstance().request('POST', '/groups', body, {
+        header: { 'Content-Type': 'application/json' }
+    }, 'raw');
+    if (response.status === 201) {
+        return { message: 'Created' };
+    }
+    else {
+        return { status: response.status, message: response.statusText };
+    }
+}

package/dist/api/repository.js

@@ -26,3 +26,20 @@ export async function listGroupRepositories(group, params) {
 export async function getRepository(repo) {
     return CnbApiClient.getInstance().request('GET', `/${repo}`);
 }
+export async function createRepository(group, params) {
+    const body = Object.entries(params).reduce((acc, [key, value]) => {
+        if (value === undefined)
+            return acc;
+        Object.assign(acc, { [key]: value });
+        return acc;
+    }, {});
+    const response = await CnbApiClient.getInstance().request('POST', `/${group}/-/repos`, body, {
+        header: { 'Content-Type': 'application/json' }
+    }, 'raw');
+    if (response.status === 201) {
+        return { message: 'Created' };
+    }
+    else {
+        return { status: response.status, message: response.statusText };
+    }
+}

package/dist/api/user.js

@@ -0,0 +1,5 @@
+import CnbApiClient from './client.js';
+export async function getUser() {
+    const cnbInst = CnbApiClient.getInstance();
+    return cnbInst.request('GET', '/user');
+}

package/dist/tools/groupTools.js

@@ -0,0 +1,121 @@
+import { z } from 'zod';
+import { createGroup, getGroup, listGroups, listSubGroups } from '../api/group.js';
+export default function registerGroupTools(server) {
+    server.tool('list-groups', '获取当前用户拥有权限的顶层组织列表', {
+        page: z.number().default(1).describe('第几页，从1开始'),
+        page_size: z.number().default(10).describe('每页多少条数据'),
+        search: z.preprocess((val) => (val === null ? undefined : val), z.string().optional()).describe('仓库关键字'),
+        role: z
+            .preprocess((val) => (val === null ? undefined : val), z.enum(['Guest', 'Reporter', 'Developer', 'Master', 'Owner']).optional())
+            .describe('最小仓库权限')
+    }, async ({ page, page_size, search, role }) => {
+        try {
+            const repos = await listGroups({ page, page_size, search, role });
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify(repos, null, 2)
+                    }
+                ]
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error listing repositories: ${error instanceof Error ? error.message : String(error)}`
+                    }
+                ],
+                isError: true
+            };
+        }
+    });
+    server.tool('list-sub-groups', '查询当前用户在指定组织下拥有指定权限的子组织列表', {
+        group: z.string().describe('组织名称'),
+        page: z.number().default(1).describe('第几页，从1开始'),
+        page_size: z.number().default(10).describe('每页多少条数据'),
+        access: z.preprocess((val) => (val === null ? undefined : val), z.number().optional()).describe('权限等级')
+    }, async ({ group, page, page_size, access }) => {
+        try {
+            const subGroups = await listSubGroups(group, { page, page_size, access });
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify(subGroups, null, 2)
+                    }
+                ]
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error listing repositories: ${error instanceof Error ? error.message : String(error)}`
+                    }
+                ],
+                isError: true
+            };
+        }
+    });
+    server.tool('get-group', '获取指定组织信息', {
+        group: z.string().describe('组织路径')
+    }, async ({ group }) => {
+        try {
+            const data = await getGroup(group);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify(data, null, 2)
+                    }
+                ]
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error getting repository: ${error instanceof Error ? error.message : String(error)}`
+                    }
+                ],
+                isError: true
+            };
+        }
+    });
+    server.tool('create-group', '创建新组织', {
+        path: z.string().describe('组织路径'),
+        description: z.preprocess((val) => (val === null ? undefined : val), z.string().optional()).describe('组织描述'),
+        remark: z.preprocess((val) => (val === null ? undefined : val), z.string().optional()).describe('仓库备注'),
+        bind_domain: z
+            .preprocess((val) => (val === null ? undefined : val), z.string().optional())
+            .describe('根组织绑定的域名')
+    }, async ({ path, description, remark, bind_domain }) => {
+        try {
+            const data = await createGroup({ path, description, remark, bind_domain });
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify(data, null, 2)
+                    }
+                ]
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error creating repository: ${error instanceof Error ? error.message : String(error)}`
+                    }
+                ],
+                isError: true
+            };
+        }
+    });
+}

package/dist/tools/index.js

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

package/dist/tools/repoTools.js

@@ -1,5 +1,6 @@
 import { z } from 'zod';
-import { getRepository, listGroupRepositories, listRepositories } from '../api/repository.js';
+import { createRepository, getRepository, listGroupRepositories, listRepositories } from '../api/repository.js';
+import { getUser } from '../api/user.js';
 export default function registerRepoTools(server) {
     server.tool('list-repositories', '获取当前用户拥有指定权限及其以上权限的仓库', {
         page: z.number().default(1).describe('第几页，从1开始'),
@@ -112,4 +113,41 @@ export default function registerRepoTools(server) {
             };
         }
     });
+    server.tool('create-repository', '创建仓库', {
+        group: z.preprocess((val) => (val === null ? undefined : val), z.string().optional()).describe('仓库所属分组'),
+        name: z.string().describe('仓库名称'),
+        description: z.preprocess((val) => (val === null ? undefined : val), z.string().optional()).describe('仓库描述'),
+        license: z.preprocess((val) => (val === null ? undefined : val), z.string().optional()).describe('仓库许可'),
+        visibility: z
+            .preprocess((val) => (val === null ? undefined : val), z.enum(['public', 'private', 'secret']).default('public'))
+            .describe('仓库可见性')
+    }, async ({ group, name, description, license, visibility }) => {
+        let repoGroup = group;
+        if (!repoGroup) {
+            const { username = '' } = await getUser();
+            repoGroup = username;
+        }
+        try {
+            const data = await createRepository(repoGroup, { name, description, license, visibility });
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify(data, null, 2)
+                    }
+                ]
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error creating repository: ${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.3.1",
+  "version": "0.3.3",
   "main": "./dist/index.js",
   "bin": {
     "cnb-mcp-server": "dist/index.js"