@prmichaelsen/acp-mcp 0.1.0 → 0.2.0

package/.env.example

@@ -1,5 +1,11 @@
 # Logging
 LOG_LEVEL=info
 
-# Add your environment variables here
-# EXAMPLE_API_KEY=your-api-key-here
+# SSH Configuration (required for standalone server)
+SSH_HOST=example.com
+SSH_PORT=22
+SSH_USERNAME=your-username
+SSH_PRIVATE_KEY_PATH=/path/to/your/private/key
+
+# Note: When using with mcp-auth, SSH credentials are provided
+# programmatically via the createServer() factory function

package/CHANGELOG.md

@@ -0,0 +1,46 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.2.0] - 2026-02-22
+
+### Added
+- SSH-based remote file listing functionality
+- `ssh2` library integration for remote machine connections
+- `SSHConnectionManager` utility class for managing SSH connections
+- `ServerConfig` interface for SSH credentials (host, port, username, privateKey)
+- Environment variable configuration for standalone server (SSH_HOST, SSH_USERNAME, SSH_PRIVATE_KEY_PATH)
+- TypeScript declaration files (.d.ts) generation in build process
+- Comprehensive SSH configuration documentation in README
+
+### Changed
+- `acp_remote_list_files` tool now operates on remote machines via SSH instead of local filesystem
+- `createServer()` factory function now accepts `ServerConfig` with SSH credentials
+- Server initialization now establishes SSH connection before starting
+- Updated `.env.example` with SSH configuration variables
+- Enhanced README with SSH setup instructions for both standalone and mcp-auth usage
+
+### Technical Details
+- Added `src/types/ssh-config.ts` for SSH configuration types
+- Added `src/utils/ssh-connection.ts` for SSH connection management
+- Updated `src/config.ts` to load SSH credentials from environment
+- Updated `src/server.ts` to use SSH for remote operations
+- Updated `src/server-factory.ts` to accept SSH config parameter
+- Updated `src/tools/acp-remote-list-files.ts` to use SSH instead of local fs
+- Build process now generates TypeScript declarations alongside JavaScript
+
+## [0.1.0] - 2026-02-22
+
+### Added
+- Initial MCP server scaffold
+- TypeScript configuration for ESM modules
+- Dual export pattern (standalone + factory for mcp-auth)
+- esbuild configuration for fast builds
+- `acp_remote_list_files` tool (local filesystem - replaced in 0.2.0)
+- Development workflow scripts
+- Complete documentation
+- Jest test configuration with colocated tests
+- prepublishOnly build hook

package/README.md

@@ -41,8 +41,17 @@ Add to your Claude Desktop configuration:
 
 ```typescript
 import { createServer } from '@prmichaelsen/acp-mcp/factory';
-
-const server = await createServer('user-123');
+import { readFileSync } from 'fs';
+
+const server = await createServer({
+  userId: 'user-123',
+  ssh: {
+    host: 'remote.example.com',
+    port: 22,
+    username: 'remote-user',
+    privateKey: readFileSync('/path/to/private/key', 'utf-8'),
+  },
+});
 ```
 
 ## Available Tools
@@ -53,12 +62,44 @@ const server = await createServer('user-123');
 
 ## Configuration
 
-Copy `.env.example` to `.env` and configure:
+### Standalone Server Configuration
+
+Copy `.env.example` to `.env` and configure SSH credentials:
 
 ```bash
 cp .env.example .env
 ```
 
+Edit `.env` with your SSH connection details:
+
+```bash
+# SSH Configuration (required)
+SSH_HOST=your-remote-server.com
+SSH_PORT=22
+SSH_USERNAME=your-username
+SSH_PRIVATE_KEY_PATH=/path/to/your/ssh/private/key
+```
+
+### mcp-auth Configuration
+
+When using with mcp-auth, SSH credentials are provided programmatically:
+
+```typescript
+import { createServer } from '@prmichaelsen/acp-mcp/factory';
+import { readFileSync } from 'fs';
+
+// SSH credentials provided by mcp-auth wrapper
+const server = await createServer({
+  userId: 'user-123',
+  ssh: {
+    host: process.env.REMOTE_HOST,
+    port: parseInt(process.env.REMOTE_PORT || '22'),
+    username: process.env.REMOTE_USERNAME,
+    privateKey: readFileSync(process.env.REMOTE_KEY_PATH, 'utf-8'),
+  },
+});
+```
+
 ## Scripts
 
 - `npm run dev` - Start development server with hot reload

package/dist/config.d.ts

@@ -1,4 +1,14 @@
 export interface Config {
     logLevel: string;
+    ssh: {
+        host: string;
+        port: number;
+        username: string;
+        privateKeyPath: string;
+    };
 }
 export declare const config: Config;
+/**
+ * Load SSH private key from file
+ */
+export declare function loadSSHPrivateKey(): string;

package/dist/server-factory.d.ts

@@ -1,9 +1,10 @@
 import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { ServerConfig } from './types/ssh-config.js';
 /**
- * Create an MCP server instance for a specific user
+ * Create an MCP server instance for a specific user with SSH configuration
  * This factory function is used by mcp-auth for multi-tenant support
  *
- * @param userId - The unique identifier for the user
+ * @param serverConfig - Configuration including userId and SSH credentials
  * @returns Configured MCP Server instance
  */
-export declare function createServer(userId: string): Promise<Server>;
+export declare function createServer(serverConfig: ServerConfig): Promise<Server>;