tabby-mcp-server 1.0.2

package/package.json

@@ -0,0 +1,84 @@
+{
+  "name": "tabby-mcp-server",
+  "version": "1.0.2",
+  "description": "MCP (Model Context Protocol) server plugin for Tabby terminal - Complete terminal control with 18 MCP tools",
+  "homepage": "https://github.com/GentlemanHu/Tabby-MCP",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/GentlemanHu/Tabby-MCP.git"
+  },
+  "bugs": {
+    "url": "https://github.com/GentlemanHu/Tabby-MCP/issues"
+  },
+  "keywords": [
+    "tabby-plugin",
+    "mcp",
+    "model-context-protocol",
+    "terminal",
+    "ai",
+    "cursor",
+    "windsurf",
+    "ssh",
+    "sse"
+  ],
+  "main": "dist/index.js",
+  "typings": "typings/index.d.ts",
+  "scripts": {
+    "build": "webpack --progress --color",
+    "watch": "webpack --progress --color --watch",
+    "install-plugin": "bash scripts/install.sh",
+    "uninstall-plugin": "bash scripts/uninstall.sh"
+  },
+  "files": [
+    "dist",
+    "typings"
+  ],
+  "author": "GentlemanHu <gentlemanhu@github.com>",
+  "contributors": [
+    "AI Assistant (Claude/Gemini)"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.8.0",
+    "@xterm/addon-serialize": "^0.12.0",
+    "cors": "^2.8.5",
+    "express": "^4.18.2",
+    "zod": "^3.22.4"
+  },
+  "peerDependencies": {
+    "@angular/animations": "*",
+    "@angular/common": "*",
+    "@angular/core": "*",
+    "@angular/forms": "*",
+    "@ng-bootstrap/ng-bootstrap": "*",
+    "rxjs": "*",
+    "tabby-core": "*",
+    "tabby-settings": "*",
+    "tabby-terminal": "*"
+  },
+  "devDependencies": {
+    "@angular/common": "^17.3.0",
+    "@angular/core": "^17.3.0",
+    "@angular/forms": "^17.3.0",
+    "@angular/animations": "^17.3.0",
+    "@angular/platform-browser": "^17.3.0",
+    "@ng-bootstrap/ng-bootstrap": "^16.0.0",
+    "rxjs": "^7.8.0",
+    "tabby-core": "^1.0.163",
+    "tabby-settings": "^1.0.163",
+    "tabby-terminal": "^1.0.163",
+    "@types/cors": "^2.8.17",
+    "@types/express": "^4.17.21",
+    "@types/node": "^20.10.0",
+    "apply-loader": "^2.0.0",
+    "css-loader": "^6.8.1",
+    "sass": "^1.69.0",
+    "sass-loader": "^13.3.2",
+    "strip-ansi": "^7.1.0",
+    "style-loader": "^3.3.3",
+    "ts-loader": "^9.5.0",
+    "typescript": "^5.3.0",
+    "webpack": "^5.89.0",
+    "webpack-cli": "^5.1.4"
+  }
+}

package/typings/components/mcpSettingsTab.component.d.ts

@@ -0,0 +1,20 @@
+import { ConfigService } from 'tabby-core';
+import { McpService } from '../services/mcpService';
+import { McpLoggerService } from '../services/mcpLogger.service';
+/**
+ * MCP Settings Tab Component
+ */
+export declare class McpSettingsTabComponent {
+    config: ConfigService;
+    private mcpService;
+    private logger;
+    constructor(config: ConfigService, mcpService: McpService, logger: McpLoggerService);
+    get isRunning(): boolean;
+    get activeConnections(): number;
+    toggleServer(): Promise<void>;
+    restartServer(): Promise<void>;
+    viewLogs(): void;
+    clearLogs(): void;
+    getConfigExample(): string;
+    copyConfig(): void;
+}

package/typings/index.d.ts

@@ -0,0 +1,37 @@
+import { AppService, ConfigService } from 'tabby-core';
+import { McpService } from './services/mcpService';
+import { McpLoggerService } from './services/mcpLogger.service';
+import { TerminalToolCategory } from './tools/terminal';
+import { TabManagementToolCategory } from './tools/tabManagement';
+import './styles.scss';
+/**
+ * MCP Module - Main Angular module for the Tabby MCP plugin
+ *
+ * Features:
+ * - Complete terminal control (exec, buffer, abort)
+ * - Tab management (create, close, duplicate, move, select)
+ * - Profile management (list, open, quick connect SSH)
+ * - Pair programming mode with command confirmation
+ * - Comprehensive logging
+ */
+export default class McpModule {
+    private app;
+    private config;
+    private mcpService;
+    private logger;
+    private terminalTools;
+    private tabManagementTools;
+    private initialized;
+    constructor(app: AppService, config: ConfigService, mcpService: McpService, logger: McpLoggerService, terminalTools: TerminalToolCategory, tabManagementTools: TabManagementToolCategory);
+    /**
+     * Initialize MCP server on application boot
+     */
+    private initializeOnBoot;
+}
+export * from './services/mcpService';
+export * from './services/mcpLogger.service';
+export * from './services/mcpConfigProvider';
+export * from './services/dialog.service';
+export * from './tools/terminal';
+export * from './tools/tabManagement';
+export * from './types/types';

package/typings/services/dialog.service.d.ts

@@ -0,0 +1,18 @@
+import { NgbModal } from '@ng-bootstrap/ng-bootstrap';
+import { McpLoggerService } from './mcpLogger.service';
+/**
+ * Dialog Service - Handles command confirmation dialogs
+ */
+export declare class DialogService {
+    private modal;
+    private logger;
+    constructor(modal: NgbModal, logger: McpLoggerService);
+    /**
+     * Show command confirmation dialog
+     */
+    showCommandConfirmation(command: string, tabId: number): Promise<boolean>;
+    /**
+     * Show command result dialog
+     */
+    showCommandResult(command: string, output: string, success: boolean): void;
+}

package/typings/services/mcpConfigProvider.d.ts

@@ -0,0 +1,20 @@
+import { ConfigProvider } from 'tabby-core';
+/**
+ * MCP Configuration Provider - Default settings for the plugin
+ */
+export declare class McpConfigProvider extends ConfigProvider {
+    defaults: {
+        mcp: {
+            port: number;
+            host: string;
+            enableLogging: boolean;
+            startOnBoot: boolean;
+            logLevel: string;
+            pairProgrammingMode: {
+                enabled: boolean;
+                showConfirmationDialog: boolean;
+                autoFocusTerminal: boolean;
+            };
+        };
+    };
+}

package/typings/services/mcpLogger.service.d.ts

@@ -0,0 +1,37 @@
+import { ConfigService } from 'tabby-core';
+import { LogEntry } from '../types/types';
+/**
+ * MCP Logger Service - Centralized logging with file persistence
+ */
+export declare class McpLoggerService {
+    private config;
+    private logs;
+    private maxLogs;
+    private prefix;
+    constructor(config: ConfigService);
+    private get isLoggingEnabled();
+    private get logLevel();
+    private shouldLog;
+    private formatMessage;
+    private addLog;
+    debug(message: string, ...args: any[]): void;
+    info(message: string, ...args: any[]): void;
+    warn(message: string, ...args: any[]): void;
+    error(message: string, ...args: any[]): void;
+    /**
+     * Get all logs
+     */
+    getLogs(): LogEntry[];
+    /**
+     * Get logs filtered by level
+     */
+    getLogsByLevel(level: 'debug' | 'info' | 'warn' | 'error'): LogEntry[];
+    /**
+     * Clear all logs
+     */
+    clearLogs(): void;
+    /**
+     * Export logs as JSON string
+     */
+    exportLogs(): string;
+}

package/typings/services/mcpService.d.ts

@@ -0,0 +1,58 @@
+import { ConfigService } from 'tabby-core';
+import { McpLoggerService } from './mcpLogger.service';
+import { ToolCategory, McpTool } from '../types/types';
+/**
+ * MCP Server Service - Core MCP server with SSE transport
+ */
+export declare class McpService {
+    config: ConfigService;
+    private logger;
+    private server;
+    private transports;
+    private app;
+    private httpServer?;
+    private isRunning;
+    private toolCategories;
+    constructor(config: ConfigService, logger: McpLoggerService);
+    /**
+     * Initialize the MCP server
+     */
+    private initializeServer;
+    /**
+     * Register a tool category with the MCP server
+     */
+    registerToolCategory(category: ToolCategory): void;
+    /**
+     * Register a single tool
+     */
+    registerTool(tool: McpTool): void;
+    /**
+     * Configure Express server with SSE endpoints
+     */
+    private configureExpress;
+    /**
+     * Configure HTTP API endpoints for direct tool access
+     */
+    private configureToolEndpoints;
+    /**
+     * Start the MCP server
+     */
+    startServer(port?: number): Promise<void>;
+    /**
+     * Stop the MCP server
+     */
+    stopServer(): Promise<void>;
+    /**
+     * Restart the MCP server
+     */
+    restartServer(): Promise<void>;
+    /**
+     * Check if server is running
+     */
+    isServerRunning(): boolean;
+    /**
+     * Get active connections count
+     */
+    getActiveConnections(): number;
+}
+export * from '../types/types';

package/typings/settings.d.ts

@@ -0,0 +1,10 @@
+import { SettingsTabProvider } from 'tabby-settings';
+/**
+ * MCP Settings Tab Provider
+ */
+export declare class McpSettingsTabProvider extends SettingsTabProvider {
+    id: string;
+    icon: string;
+    title: string;
+    getComponentType(): any;
+}

package/typings/tools/base-tool-category.d.ts

@@ -0,0 +1,15 @@
+import { McpTool, ToolCategory } from '../types/types';
+import { McpLoggerService } from '../services/mcpLogger.service';
+/**
+ * Base class for tool categories
+ */
+export declare abstract class BaseToolCategory implements ToolCategory {
+    protected logger: McpLoggerService;
+    abstract name: string;
+    mcpTools: McpTool[];
+    constructor(logger: McpLoggerService);
+    /**
+     * Register a tool with this category
+     */
+    protected registerTool(tool: McpTool): void;
+}

package/typings/tools/tabManagement.d.ts

@@ -0,0 +1,29 @@
+import { AppService, ConfigService, ProfilesService } from 'tabby-core';
+import { BaseToolCategory } from './base-tool-category';
+import { McpLoggerService } from '../services/mcpLogger.service';
+/**
+ * Tab Management Tools Category - Comprehensive tab and profile management
+ */
+export declare class TabManagementToolCategory extends BaseToolCategory {
+    private app;
+    private config;
+    private profilesService;
+    name: string;
+    constructor(app: AppService, logger: McpLoggerService, config: ConfigService, profilesService: ProfilesService);
+    private initializeTools;
+    private createListTabsTool;
+    private createSelectTabTool;
+    private createCloseTabTool;
+    private createCloseAllTabsTool;
+    private createDuplicateTabTool;
+    private createNextTabTool;
+    private createPreviousTabTool;
+    private createMoveTabLeftTool;
+    private createMoveTabRightTool;
+    private createReopenLastTabTool;
+    private createListProfilesTool;
+    private createOpenProfileTool;
+    private createShowProfileSelectorTool;
+    private createQuickConnectTool;
+    private createSplitTabTool;
+}

package/typings/tools/terminal.d.ts

@@ -0,0 +1,68 @@
+import { AppService, BaseTabComponent, ConfigService } from 'tabby-core';
+import { BaseTerminalTabComponent } from 'tabby-terminal';
+import { BaseToolCategory } from './base-tool-category';
+import { McpLoggerService } from '../services/mcpLogger.service';
+import { DialogService } from '../services/dialog.service';
+import { ActiveCommand } from '../types/types';
+/**
+ * Terminal session with ID for tracking
+ */
+export interface TerminalSessionWithTab {
+    id: number;
+    tabParent: BaseTabComponent;
+    tab: BaseTerminalTabComponent;
+}
+/**
+ * Terminal Tools Category - Commands for terminal control
+ */
+export declare class TerminalToolCategory extends BaseToolCategory {
+    private app;
+    private config;
+    private dialogService;
+    name: string;
+    private _activeCommands;
+    private _activeCommandsSubject;
+    readonly activeCommands$: import("rxjs").Observable<Map<number, ActiveCommand>>;
+    constructor(app: AppService, logger: McpLoggerService, config: ConfigService, dialogService: DialogService);
+    /**
+     * Initialize all terminal tools
+     */
+    private initializeTools;
+    /**
+     * Tool: Get list of terminal sessions
+     */
+    private createGetSessionListTool;
+    /**
+     * Tool: Execute command in terminal
+     * Enhanced with better timeout handling and interactive command detection
+     */
+    private createExecCommandTool;
+    /**
+     * Tool: Send raw input to terminal (for interactive commands)
+     */
+    private createSendInputTool;
+    /**
+     * Tool: Get terminal buffer content
+     */
+    private createGetTerminalBufferTool;
+    /**
+     * Tool: Abort running command
+     */
+    private createAbortCommandTool;
+    /**
+     * Tool: Get status of active commands
+     */
+    private createGetCommandStatusTool;
+    /**
+     * Find all terminal sessions
+     */
+    findTerminalSessions(): TerminalSessionWithTab[];
+    /**
+     * Get terminal buffer as text
+     */
+    private getTerminalBufferText;
+    /**
+     * Wait for command output between markers
+     */
+    private waitForCommandOutput;
+}

package/typings/types/types.d.ts

@@ -0,0 +1,83 @@
+/**
+ * MCP Tool definition interface
+ */
+export interface McpTool {
+    name: string;
+    description: string;
+    schema: Record<string, any>;
+    handler: (params: any, context: any) => Promise<any>;
+}
+/**
+ * Tool category interface for grouping related tools
+ */
+export interface ToolCategory {
+    name: string;
+    mcpTools: McpTool[];
+}
+/**
+ * Terminal session information
+ */
+export interface TerminalSession {
+    id: number;
+    title: string;
+    type: string;
+    isActive: boolean;
+}
+/**
+ * Command execution result
+ */
+export interface CommandResult {
+    success: boolean;
+    output: string;
+    exitCode?: number;
+    error?: string;
+    outputId?: string;
+    totalLines?: number;
+}
+/**
+ * Active command tracking
+ */
+export interface ActiveCommand {
+    tabId: number;
+    command: string;
+    timestamp: number;
+    startMarker: string;
+    endMarker: string;
+    abort: () => void;
+}
+/**
+ * MCP Configuration
+ */
+export interface McpConfig {
+    port: number;
+    host: string;
+    enableLogging: boolean;
+    startOnBoot: boolean;
+    logLevel: 'debug' | 'info' | 'warn' | 'error';
+    pairProgrammingMode: {
+        enabled: boolean;
+        showConfirmationDialog: boolean;
+        autoFocusTerminal: boolean;
+    };
+}
+/**
+ * Command history entry
+ */
+export interface CommandHistoryEntry {
+    id: string;
+    tabId: number;
+    command: string;
+    timestamp: number;
+    status: 'running' | 'completed' | 'aborted' | 'error';
+    output?: string;
+    exitCode?: number;
+}
+/**
+ * Log entry
+ */
+export interface LogEntry {
+    timestamp: Date;
+    level: 'debug' | 'info' | 'warn' | 'error';
+    message: string;
+    context?: any;
+}