@cnbcool/mcp-server 0.1.0-beta.0

package/CHANGELOG.md

@@ -0,0 +1,9 @@
+## 0.1.0 (March 17, 2025)
+
+### New Features
+
+- Supports list user repositories with various filters
+- Supports get repository details
+- Supports list repository issues with various filters
+- Supports get issue details
+- Supports create repository issue

package/README.md

@@ -0,0 +1,46 @@
+# CNB.COOL MCP Server
+
+https://cnb.cool toolkits for LLMs supporting the MCP protocol
+
+## How to develop
+
+1. `npm install`
+2. Rename `.env.example` to `.env` and fill in the values
+3. `npm build`
+4. `npx @modelcontextprotocol/inspector node dist/index.js`
+
+## How to configure
+
+### Local
+
+```json
+{
+  "mcpServers": {
+    "cnb": {
+      "command": "node",
+      "args": ["/path/to/cnbcool/mcp-server/dist/index.js"],
+      "env": {
+        "API_BASE_URL": "<BASE_URL>",
+        "API_TOKEN": "<YOUR_TOKEN>"
+      }
+    }
+  }
+}
+```
+
+### Production
+
+```json
+{
+  "mcpServers": {
+    "cnb": {
+      "command": "npx",
+      "args": ["-y", "@cnbcool/mcp-server"],
+      "env": {
+        "API_BASE_URL": "<BASE_URL>",
+        "API_TOKEN": "<YOUR_TOKEN>"
+      }
+    }
+  }
+}
+```

package/dist/CnbApiClient.js

@@ -0,0 +1,65 @@
+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 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' } });
+    }
+}

package/dist/index.js

@@ -0,0 +1,25 @@
+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.js";
+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-cool",
+    version: "0.0.1"
+});
+registerTools(server, cnbApiClient);
+async function main() {
+    console.error("server starting...");
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("server connected");
+}
+main().catch(error => {
+    console.error("Fatal error:", error);
+    process.exit(1);
+});

package/dist/tools.js

@@ -0,0 +1,119 @@
+import { z } from "zod";
+export function registerTools(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("排序顺序")
+    }, 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 });
+            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("get-repository", "获取指定仓库信息", {
+        repoId: z.string().describe("仓库 ID")
+    }, async ({ repoId }) => {
+        try {
+            const repo = await cnbApi.getRepository(repoId);
+            return {
+                content: [{
+                        type: "text",
+                        text: JSON.stringify(repo, null, 2)
+                    }]
+            };
+        }
+        catch (error) {
+            return {
+                content: [{
+                        type: "text",
+                        text: `Error getting repository: ${error instanceof Error ? error.message : String(error)}`
+                    }],
+                isError: true
+            };
+        }
+    });
+    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 });
+            return {
+                content: [{
+                        type: "text",
+                        text: JSON.stringify(issues, null, 2)
+                    }]
+            };
+        }
+        catch (error) {
+            return {
+                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 优先级")
+    }, async ({ repoId, title, body, assignees, labels, priority }) => {
+        try {
+            const issue = await cnbApi.createIssue(repoId, {
+                title,
+                body,
+                assignees,
+                labels,
+                priority
+            });
+            return {
+                content: [{
+                        type: "text",
+                        text: `Issue created successfully:\n${JSON.stringify(issue, null, 2)}`
+                    }]
+            };
+        }
+        catch (error) {
+            return {
+                content: [{
+                        type: "text",
+                        text: `Error creating issue: ${error instanceof Error ? error.message : String(error)}`
+                    }],
+                isError: true
+            };
+        }
+    });
+}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@cnbcool/mcp-server",
+  "description": "CMB MCP server",
+  "version": "0.1.0-beta.0",
+  "main": "./dist/index.js",
+  "type": "module",
+  "scripts": {
+    "postinstall": "openapi-typescript https://api.cnb.cool/swagger.json -o src/schema.d.ts",
+    "build": "tsc",
+    "start": "node dist/index.js"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://cnb.cool/cnb/tools/mcp-server.git"
+  },
+  "keywords": [
+    "cnb",
+    "cloud native build",
+    "model context protocol",
+    "mcp server"
+  ],
+  "license": "MIT",
+  "files": [
+    "dist/",
+    "package.json",
+    "CHANGELOG.md",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">= 20",
+    "typescript": ">=5.5"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.6.1",
+    "dotenv": "^16.4.7",
+    "zod": "^3.24.2"
+  },
+  "devDependencies": {
+    "@types/node": "^22.13.9",
+    "openapi-typescript": "^5.4.2",
+    "typescript": "^5.8.2"
+  }
+}