cc-lark 0.1.1

package/dist/tools/wiki/node.js

@@ -0,0 +1,112 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * feishu_wiki_node tool - Manage Feishu Wiki nodes.
+ *
+ * Actions: list, get
+ */
+import { z } from 'zod';
+import { getValidAccessToken, NeedAuthorizationError } from '../../core/uat-client.js';
+import { assertLarkOk } from '../../core/api-error.js';
+import { json, jsonError } from '../im/helpers.js';
+import { logger } from '../../utils/logger.js';
+const log = logger('tools:wiki:node');
+// Schemas
+const listActionSchema = {
+    action: z.literal('list').describe('List wiki nodes in a space'),
+    space_id: z.string().describe('Space ID'),
+    parent_node_token: z.string().optional().describe('Parent node token (optional, for listing sub-nodes)'),
+    page_size: z.number().min(1).max(50).optional().describe('Page size (default 50)'),
+    page_token: z.string().optional().describe('Pagination token'),
+};
+const getActionSchema = {
+    action: z.literal('get').describe('Get a wiki node'),
+    token: z.string().describe('Node token'),
+};
+async function getAccessToken(context) {
+    const { larkClient, config } = context;
+    if (!larkClient)
+        return jsonError('LarkClient not initialized.');
+    const { appId, appSecret, brand } = config;
+    if (!appId || !appSecret)
+        return jsonError('Missing FEISHU_APP_ID or FEISHU_APP_SECRET.');
+    const { listStoredTokens } = await import('../../core/token-store.js');
+    const tokens = await listStoredTokens(appId);
+    if (tokens.length === 0)
+        return jsonError('No user authorization found.');
+    const userOpenId = tokens[0].userOpenId;
+    try {
+        return await getValidAccessToken({ userOpenId, appId, appSecret, domain: brand ?? 'feishu' });
+    }
+    catch (err) {
+        if (err instanceof NeedAuthorizationError)
+            return jsonError('User authorization expired.');
+        throw err;
+    }
+}
+export function registerWikiNodeTool(registry) {
+    registry.register({
+        name: 'feishu_wiki_node_list',
+        description: 'List Feishu wiki nodes in a space.\n\nRequires OAuth authorization.',
+        inputSchema: listActionSchema,
+        handler: async (args, context) => {
+            const p = args;
+            const { larkClient } = context;
+            const tokenResult = await getAccessToken(context);
+            if (typeof tokenResult === 'object' && 'content' in tokenResult)
+                return tokenResult;
+            const accessToken = tokenResult;
+            log.info(`list: space_id=${p.space_id}, parent=${p.parent_node_token ?? 'root'}`);
+            const Lark = await import('@larksuiteoapi/node-sdk');
+            const opts = Lark.withUserAccessToken(accessToken);
+            const res = await larkClient.sdk.wiki.spaceNode.list({
+                path: { space_id: p.space_id },
+                params: {
+                    parent_node_token: p.parent_node_token,
+                    page_size: p.page_size,
+                    page_token: p.page_token,
+                },
+            }, opts);
+            assertLarkOk(res);
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            const data = res.data;
+            return json({
+                nodes: data?.items,
+                has_more: data?.has_more,
+                page_token: data?.page_token,
+            });
+        },
+    });
+    registry.register({
+        name: 'feishu_wiki_node_get',
+        description: 'Get a Feishu wiki node by token.\n\nRequires OAuth authorization.',
+        inputSchema: getActionSchema,
+        handler: async (args, context) => {
+            const p = args;
+            const { larkClient } = context;
+            const tokenResult = await getAccessToken(context);
+            if (typeof tokenResult === 'object' && 'content' in tokenResult)
+                return tokenResult;
+            const accessToken = tokenResult;
+            log.info(`get: token=${p.token}`);
+            const Lark = await import('@larksuiteoapi/node-sdk');
+            const opts = Lark.withUserAccessToken(accessToken);
+            // Use direct request since SDK doesn't have a get method for node
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            const res = await larkClient.sdk.request({
+                method: 'GET',
+                url: `/open-apis/wiki/v2/spaces/get_node?token=${p.token}`,
+            }, opts);
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            if (res.code !== undefined && res.code !== 0) {
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                return jsonError(`API Error: code=${res.code}, msg=${res.msg}`);
+            }
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            return json({ node: res.data?.node });
+        },
+    });
+    log.debug('feishu_wiki_node tools registered');
+}
+//# sourceMappingURL=node.js.map

package/dist/tools/wiki/node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.js","sourceRoot":"","sources":["../../../src/tools/wiki/node.ts"],"names":[],"mappings":"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"}

package/dist/tools/wiki/space.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * feishu_wiki_space tool - Manage Feishu Wiki spaces.
+ *
+ * Actions: list, get, create
+ */
+import type { ToolRegistry } from '../index.js';
+export declare function registerWikiSpaceTool(registry: ToolRegistry): void;
+//# sourceMappingURL=space.d.ts.map

package/dist/tools/wiki/space.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"space.d.ts","sourceRoot":"","sources":["../../../src/tools/wiki/space.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AA8ChD,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI,CA+FlE"}

package/dist/tools/wiki/space.js

@@ -0,0 +1,125 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * feishu_wiki_space tool - Manage Feishu Wiki spaces.
+ *
+ * Actions: list, get, create
+ */
+import { z } from 'zod';
+import { getValidAccessToken, NeedAuthorizationError } from '../../core/uat-client.js';
+import { assertLarkOk } from '../../core/api-error.js';
+import { json, jsonError } from '../im/helpers.js';
+import { logger } from '../../utils/logger.js';
+const log = logger('tools:wiki:space');
+// Schemas
+const listActionSchema = {
+    action: z.literal('list').describe('List wiki spaces'),
+    page_size: z.number().min(1).max(50).optional().describe('Page size (default 10)'),
+    page_token: z.string().optional().describe('Pagination token'),
+};
+const getActionSchema = {
+    action: z.literal('get').describe('Get a wiki space'),
+    space_id: z.string().describe('Space ID'),
+};
+const createActionSchema = {
+    action: z.literal('create').describe('Create a wiki space'),
+    name: z.string().optional().describe('Space name'),
+    description: z.string().optional().describe('Space description'),
+};
+async function getAccessToken(context) {
+    const { larkClient, config } = context;
+    if (!larkClient)
+        return jsonError('LarkClient not initialized.');
+    const { appId, appSecret, brand } = config;
+    if (!appId || !appSecret)
+        return jsonError('Missing FEISHU_APP_ID or FEISHU_APP_SECRET.');
+    const { listStoredTokens } = await import('../../core/token-store.js');
+    const tokens = await listStoredTokens(appId);
+    if (tokens.length === 0)
+        return jsonError('No user authorization found.');
+    const userOpenId = tokens[0].userOpenId;
+    try {
+        return await getValidAccessToken({ userOpenId, appId, appSecret, domain: brand ?? 'feishu' });
+    }
+    catch (err) {
+        if (err instanceof NeedAuthorizationError)
+            return jsonError('User authorization expired.');
+        throw err;
+    }
+}
+export function registerWikiSpaceTool(registry) {
+    registry.register({
+        name: 'feishu_wiki_space_list',
+        description: 'List Feishu wiki spaces.\n\nRequires OAuth authorization.',
+        inputSchema: listActionSchema,
+        handler: async (args, context) => {
+            const p = args;
+            const { larkClient } = context;
+            const tokenResult = await getAccessToken(context);
+            if (typeof tokenResult === 'object' && 'content' in tokenResult)
+                return tokenResult;
+            const accessToken = tokenResult;
+            log.info(`list: page_size=${p.page_size ?? 10}`);
+            const Lark = await import('@larksuiteoapi/node-sdk');
+            const opts = Lark.withUserAccessToken(accessToken);
+            const res = await larkClient.sdk.wiki.space.list({ params: { page_size: p.page_size, page_token: p.page_token } }, opts);
+            assertLarkOk(res);
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            const data = res.data;
+            return json({
+                spaces: data?.items,
+                has_more: data?.has_more,
+                page_token: data?.page_token,
+            });
+        },
+    });
+    registry.register({
+        name: 'feishu_wiki_space_get',
+        description: 'Get a Feishu wiki space by ID.\n\nRequires OAuth authorization.',
+        inputSchema: getActionSchema,
+        handler: async (args, context) => {
+            const p = args;
+            const { larkClient } = context;
+            const tokenResult = await getAccessToken(context);
+            if (typeof tokenResult === 'object' && 'content' in tokenResult)
+                return tokenResult;
+            const accessToken = tokenResult;
+            log.info(`get: space_id=${p.space_id}`);
+            const Lark = await import('@larksuiteoapi/node-sdk');
+            const opts = Lark.withUserAccessToken(accessToken);
+            const res = await larkClient.sdk.wiki.space.get({ path: { space_id: p.space_id } }, opts);
+            assertLarkOk(res);
+            return json({ space: res.data?.space });
+        },
+    });
+    registry.register({
+        name: 'feishu_wiki_space_create',
+        description: 'Create a Feishu wiki space.\n\nRequires OAuth authorization.',
+        inputSchema: createActionSchema,
+        handler: async (args, context) => {
+            const p = args;
+            const { larkClient } = context;
+            const tokenResult = await getAccessToken(context);
+            if (typeof tokenResult === 'object' && 'content' in tokenResult)
+                return tokenResult;
+            const accessToken = tokenResult;
+            log.info(`create: name=${p.name ?? '(empty)'}`);
+            const Lark = await import('@larksuiteoapi/node-sdk');
+            const opts = Lark.withUserAccessToken(accessToken);
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            const data = {};
+            if (p.name)
+                data.name = p.name;
+            if (p.description)
+                data.description = p.description;
+            const res = await larkClient.sdk.wiki.space.create({ data }, opts);
+            assertLarkOk(res);
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            const spaceData = res.data?.space;
+            return json({ space: res.data?.space, space_id: spaceData?.space_id });
+        },
+    });
+    log.debug('feishu_wiki_space tools registered');
+}
+//# sourceMappingURL=space.js.map

package/dist/tools/wiki/space.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"space.js","sourceRoot":"","sources":["../../../src/tools/wiki/space.ts"],"names":[],"mappings":"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"}

package/dist/utils/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * Utils module exports for cc-lark MCP Server.
+ */
+export * from './logger.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,aAAa,CAAC"}

package/dist/utils/index.js

@@ -0,0 +1,8 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * Utils module exports for cc-lark MCP Server.
+ */
+export * from './logger.js';
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,aAAa,CAAC"}

package/dist/utils/logger.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * Simple logger utility for the cc-lark MCP Server.
+ *
+ * Provides prefixed logging with ANSI color support for console output.
+ * Adapted from openclaw-lark lark-logger for MCP Server architecture.
+ */
+export interface Logger {
+    readonly subsystem: string;
+    debug(message: string, meta?: Record<string, unknown>): void;
+    info(message: string, meta?: Record<string, unknown>): void;
+    warn(message: string, meta?: Record<string, unknown>): void;
+    error(message: string, meta?: Record<string, unknown>): void;
+    child(name: string): Logger;
+}
+/**
+ * Create a logger for a subsystem.
+ *
+ * @param subsystem - Name of the subsystem (e.g., "api", "tools", "config")
+ * @returns Logger instance
+ *
+ * @example
+ * ```typescript
+ * const log = logger("api");
+ * log.info("Request started", { method: "GET", path: "/users" });
+ * log.error("Request failed", { error: "Connection timeout" });
+ * ```
+ */
+export declare function logger(subsystem: string): Logger;
+/**
+ * Default logger instance for general use.
+ */
+export declare const defaultLogger: Logger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,MAAM,WAAW,MAAM;IACrB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC7D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC5D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC5D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC7D,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;CAC7B;AA0FD;;;;;;;;;;;;GAYG;AACH,wBAAgB,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED;;GAEG;AACH,eAAO,MAAM,aAAa,QAAiB,CAAC"}

package/dist/utils/logger.js

@@ -0,0 +1,101 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * Simple logger utility for the cc-lark MCP Server.
+ *
+ * Provides prefixed logging with ANSI color support for console output.
+ * Adapted from openclaw-lark lark-logger for MCP Server architecture.
+ */
+// ---------------------------------------------------------------------------
+// ANSI colors
+// ---------------------------------------------------------------------------
+const CYAN = '\x1b[36m';
+const YELLOW = '\x1b[33m';
+const RED = '\x1b[31m';
+const GRAY = '\x1b[90m';
+const RESET = '\x1b[0m';
+// ---------------------------------------------------------------------------
+// Message formatting
+// ---------------------------------------------------------------------------
+/**
+ * Format a log message with optional metadata.
+ *
+ * @param prefix - Log prefix (subsystem tag)
+ * @param message - Log message
+ * @param meta - Optional metadata to include
+ * @returns Formatted message string
+ */
+function formatMessage(prefix, message, meta) {
+    if (!meta || Object.keys(meta).length === 0) {
+        return `${prefix} ${message}`;
+    }
+    const parts = Object.entries(meta)
+        .map(([k, v]) => {
+        if (v === undefined || v === null)
+            return null;
+        if (typeof v === 'object')
+            return `${k}=${JSON.stringify(v)}`;
+        return `${k}=${v}`;
+    })
+        .filter(Boolean);
+    return parts.length > 0 ? `${prefix} ${message} (${parts.join(', ')})` : `${prefix} ${message}`;
+}
+// ---------------------------------------------------------------------------
+// Logger implementation
+// ---------------------------------------------------------------------------
+/**
+ * Create a new logger instance.
+ *
+ * @param subsystem - Subsystem name for log prefix
+ * @returns Logger instance
+ */
+function createLogger(subsystem) {
+    const tag = `cc-lark/${subsystem}`;
+    return {
+        subsystem,
+        debug(message, meta) {
+            const formatted = formatMessage(tag, message, meta);
+            console.debug(`${GRAY}[DEBUG]${RESET}`, formatted);
+        },
+        info(message, meta) {
+            const formatted = formatMessage(tag, message, meta);
+            console.log(`${CYAN}[INFO]${RESET}`, formatted);
+        },
+        warn(message, meta) {
+            const formatted = formatMessage(tag, message, meta);
+            console.warn(`${YELLOW}[WARN]${RESET}`, formatted);
+        },
+        error(message, meta) {
+            const formatted = formatMessage(tag, message, meta);
+            console.error(`${RED}[ERROR]${RESET}`, formatted);
+        },
+        child(name) {
+            return createLogger(`${subsystem}/${name}`);
+        },
+    };
+}
+// ---------------------------------------------------------------------------
+// Public factory
+// ---------------------------------------------------------------------------
+/**
+ * Create a logger for a subsystem.
+ *
+ * @param subsystem - Name of the subsystem (e.g., "api", "tools", "config")
+ * @returns Logger instance
+ *
+ * @example
+ * ```typescript
+ * const log = logger("api");
+ * log.info("Request started", { method: "GET", path: "/users" });
+ * log.error("Request failed", { error: "Connection timeout" });
+ * ```
+ */
+export function logger(subsystem) {
+    return createLogger(subsystem);
+}
+/**
+ * Default logger instance for general use.
+ */
+export const defaultLogger = logger('core');
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"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"}

package/eslint.config.js

@@ -0,0 +1,13 @@
+import eslint from "@eslint/js";
+import tseslint from "typescript-eslint";
+
+export default tseslint.config(
+  eslint.configs.recommended,
+  ...tseslint.configs.recommended,
+  {
+    rules: {
+      "@typescript-eslint/no-unused-vars": ["error", { argsIgnorePattern: "^_" }],
+      "@typescript-eslint/explicit-function-return-type": "off"
+    }
+  }
+);

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "cc-lark",
+  "version": "0.1.1",
+  "description": "Feishu/Lark MCP Server for Claude Code",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "cc-lark": "dist/index.js"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/yes8080/cc-lark.git"
+  },
+  "bugs": {
+    "url": "https://github.com/yes8080/cc-lark/issues"
+  },
+  "homepage": "https://github.com/yes8080/cc-lark#readme",
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "tsc --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "eslint src/",
+    "lint:fix": "eslint src/ --fix",
+    "format": "prettier --write \"src/**/*.ts\"",
+    "format:check": "prettier --check \"src/**/*.ts\""
+  },
+  "dependencies": {
+    "@larksuiteoapi/node-sdk": "^1.59.0",
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "@typescript-eslint/eslint-plugin": "^8.0.0",
+    "@typescript-eslint/parser": "^8.0.0",
+    "eslint": "^9.0.0",
+    "prettier": "^3.0.0",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.57.0",
+    "vitest": "^2.0.0"
+  },
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "keywords": [
+    "feishu",
+    "lark",
+    "mcp",
+    "claude-code"
+  ],
+  "license": "MIT"
+}