feat: add initial version

Author: rgomezcasas

.github/workflows/ci.yml

@@ -0,0 +1,58 @@
+# yaml-language-server: $schema=https://json.schemastore.org/github-workflow.json
+name: CI
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+
+jobs:
+  lint-test:
+    name: 🚀 Lint and test
+    runs-on: ubuntu-latest
+    timeout-minutes: 5
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: lts/*
+          cache: npm
+      - name: 📥 Install dependencies
+        run: npm install
+      - name: 💅 Lint code style
+        run: npm run lint
+      - name: 💻 Build
+        run: npm run build
+
+  publish:
+    if: github.ref == 'refs/heads/main' && github.event_name == 'push'
+    name: 📦 Publish
+    runs-on: ubuntu-latest
+    needs: lint-test
+    timeout-minutes: 5
+    permissions:
+      # Needed by googleapis/release-please-action@v4
+      contents: write
+      pull-requests: write
+      # Needed by `npm publish --provenance`
+      id-token: write
+    steps:
+      - name: 🍄 Bump package version, create GitHub release, and update changelog
+        uses: googleapis/release-please-action@v4
+        id: release
+      - uses: actions/checkout@v4
+        if: ${{ steps.release.outputs.release_created }}
+      - uses: actions/setup-node@v4
+        if: ${{ steps.release.outputs.release_created }}
+        with:
+          node-version: lts/*
+          cache: npm
+          registry-url: https://registry.npmjs.org
+      - name: 🚀 Publish to npm
+        if: ${{ steps.release.outputs.release_created }}
+        run: |
+          npm install
+          npm run build --if-present
+          npm publish --provenance
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

.gitignore

@@ -0,0 +1,2 @@
+node_modules/
+dist/

.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "0.0.1"
+}

CHANGELOG.md

@@ -0,0 +1 @@
+# Changelog

LICENSE

@@ -0,0 +1,74 @@
+# @codelytv/mcp-test-client
+
+A TypeScript test client for Model Context Protocol (MCP) servers that provides a convenient way to test MCP functionality in your test suites.
+
+## Installation
+
+```bash
+npm install --save-dev @codelytv/mcp-test-client
+```
+
+## Usage
+
+### Basic Example
+
+```typescript
+import { McpTestClient } from '@codelytv/mcp-test-client';
+
+const mcpClient = new McpTestClient("stdio", [
+  "npx",
+  "ts-node",
+  "./src/app/mcp/server.ts",
+]);
+
+await mcpClient.connect();
+
+// List available tools
+const tools = await mcpClient.listTools();
+console.log('Available tools:', tools.names());
+
+// Call a tool
+const response = await mcpClient.callTool('search-course-by-id', { id: 'course-123' });
+
+// List resources
+const resources = await mcpClient.listResources();
+console.log('Available resources:', resources.uris());
+
+// Read a resource
+const resource = await mcpClient.readResource('courses://all');
+
+await mcpClient.disconnect();
+```
+
+### HTTP Transport
+
+```typescript
+const mcpClient = new McpTestClient("http", ["http://localhost:3000/mcp"]);
+```
+
+## API
+
+### McpTestClient
+
+The main client class for interacting with MCP servers.
+
+#### Constructor
+
+- `new McpTestClient(transport: "stdio" | "http", args: string[])`
+
+#### Methods
+
+- `connect()` - Connect to the MCP server
+- `disconnect()` - Disconnect from the MCP server
+- `listTools()` - List available tools
+- `callTool(name: string, args?: Record<string, unknown>)` - Call a tool
+- `listResources()` - List available resources
+- `readResource(uri: string)` - Read a resource
+- `listResourceTemplates()` - List resource templates
+- `completeResourceTemplateParam(uri: string, paramName: string, textToComplete: string)` - Complete resource template parameters
+- `listPrompts()` - List available prompts
+- `getPrompt(name: string, args?: Record<string, unknown>)` - Get a prompt
+
+## License
+
+MIT

README.md

@@ -0,0 +1,3 @@
+import eslintConfigCodely from "eslint-config-codely";
+
+export default [...eslintConfigCodely.ts];