mcp-insomnia 0.1.0 → 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Angga Permana
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -2,31 +2,43 @@
 
 MCP-Insomnia is an MCP (Model Context Protocol) server that enables AI agents to create and manage API collections in Insomnia-compatible format. This server provides tools and resources for managing collections, requests, and environments that can be exported to Insomnia.
 
-## Installation
+## Installation and Usage
 
 ### Prerequisites
 
 - Node.js 18+
 - npm or yarn
 
-### Install from NPM
+There are three ways to use `mcp-insomnia`.
 
-```bash
-npm install -g mcp-insomnia
+### 1. Run with NPX (Recommended)
+
+You can run `mcp-insomnia` directly using `npx` without a global installation.
+
+**Configuration:**
+
+```json
+{
+  "mcpServers": {
+    "insomnia": {
+      "command": "npx",
+      "args": ["mcp-insomnia"]
+    }
+  }
+}
 ```
 
-### Install from Source
+### 2. Install Globally from NPM
+
+Install the package globally using npm.
+
+**Installation:**
 
 ```bash
-git clone https://github.com/anggasct/mcp-insomnia.git
-cd mcp-insomnia
-npm install
-npm run build
+npm install -g mcp-insomnia
 ```
 
-### Add to MCP Configuration
-
-Add to your MCP client configuration:
+**Configuration:**
 
 ```json
 {
@@ -38,7 +50,20 @@ Add to your MCP client configuration:
 }
 ```
 
-Or if installed from source:
+### 3. Install from Source
+
+Clone the repository and build the project.
+
+**Installation:**
+
+```bash
+git clone https://github.com/anggasct/mcp-insomnia.git
+cd mcp-insomnia
+npm install
+npm run build
+```
+
+**Configuration:**
 
 ```json
 {
@@ -70,6 +95,7 @@ Or if installed from source:
 - `update_request` - Update existing request
 - `delete_request` - Delete request
 - `execute_request` - Execute request and view response
+- `generate_code_snippet` - Generate a code snippet for a request in various languages/frameworks
 
 ### Environment Management
 
@@ -116,6 +142,12 @@ Set environment variable "baseUrl" with value "https://api.example.com" for "API
 Execute "Get Users" request using the configured environment variables
 ```
 
+### Generate Code Snippet
+
+```
+Generate a code snippet for request "Get Users" in "javascript"
+```
+
 ## Data Storage
 
 Data is stored in `~/.mcp-insomnia/collections.json` in JSON format.

package/dist/run-duplication-test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=run-duplication-test.d.ts.map

package/dist/run-duplication-test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-duplication-test.d.ts","sourceRoot":"","sources":["../src/run-duplication-test.ts"],"names":[],"mappings":""}

package/dist/run-duplication-test.js

@@ -0,0 +1,58 @@
+import { storage } from './storage.js';
+import { createInsomniaTools } from './tools.js';
+async function runDuplicationTest() {
+    console.log('Starting duplication test...');
+    const tools = createInsomniaTools();
+    const createCollectionTool = tools.find(t => t.name === 'create_collection');
+    const createRequestTool = tools.find(t => t.name === 'create_request_in_collection');
+    const duplicateRequestTool = tools.find(t => t.name === 'duplicate_request');
+    const duplicateCollectionTool = tools.find(t => t.name === 'duplicate_collection');
+    if (!createCollectionTool || !createRequestTool || !duplicateRequestTool || !duplicateCollectionTool) {
+        throw new Error('One or more required tools are not defined.');
+    }
+    // 1. Setup
+    storage.clearAllCollections();
+    const collResult = await createCollectionTool.handler({ params: { arguments: { name: 'Original Collection' } } });
+    const collectionId = (collResult.content[0].text.match(/ID: (wrk_[a-zA-Z0-9]+)/) || [])[1];
+    const reqResult = await createRequestTool.handler({ params: { arguments: { collectionId, name: 'Original Request', method: 'GET', url: 'http://original.com' } } });
+    const requestId = (reqResult.content[0].text.match(/ID: (req_[a-zA-Z0-9]+)/) || [])[1];
+    console.log(`Setup complete. Collection: ${collectionId}, Request: ${requestId}`);
+    // 2. Test Request Duplication
+    console.log('Testing request duplication...');
+    const dupReqResult = await duplicateRequestTool.handler({ params: { arguments: { requestId, newName: 'Duplicated Request' } } });
+    const newRequestId = (dupReqResult.content[0].text.match(/ID: (req_[a-zA-Z0-9]+)/) || [])[1];
+    let collection = storage.getCollection(collectionId);
+    if (collection.requests.length !== 2) {
+        throw new Error(`❌ FAILED: Expected 2 requests after duplication, found ${collection.requests.length}`);
+    }
+    const newReq = collection.requests.find(r => r._id === newRequestId);
+    if (!newReq || newReq.name !== 'Duplicated Request') {
+        throw new Error('❌ FAILED: Duplicated request has incorrect data.');
+    }
+    console.log('✅ SUCCESS: Request duplication test passed.');
+    // 3. Test Collection Duplication
+    console.log('Testing collection duplication...');
+    const dupCollResult = await duplicateCollectionTool.handler({ params: { arguments: { collectionId, newName: 'Duplicated Collection' } } });
+    const newCollectionId = (dupCollResult.content[0].text.match(/ID: (wrk_[a-zA-Z0-9]+)/) || [])[1];
+    const newCollection = storage.getCollection(newCollectionId);
+    if (!newCollection) {
+        throw new Error('❌ FAILED: Duplicated collection not found in storage.');
+    }
+    if (newCollection.workspace.name !== 'Duplicated Collection') {
+        throw new Error('❌ FAILED: Duplicated collection has incorrect name.');
+    }
+    if (newCollection.requests.length !== 1 || newCollection.requests[0].name !== 'Original Request') {
+        throw new Error('❌ FAILED: Requests within duplicated collection are incorrect.');
+    }
+    if (newCollection.requests[0].parentId === requestId) {
+        throw new Error('❌ FAILED: Request parent ID was not updated during collection duplication.');
+    }
+    console.log('✅ SUCCESS: Collection duplication test passed.');
+    console.log('All duplication tests finished successfully.');
+}
+runDuplicationTest().catch(err => {
+    console.error('Test failed with an error:');
+    console.error(err);
+    process.exit(1);
+});
+//# sourceMappingURL=run-duplication-test.js.map

package/dist/run-duplication-test.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-insomnia",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "MCP server for making HTTP requests and managing API collections",
   "main": "dist/index.js",
   "type": "module",
@@ -29,6 +29,7 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "1.13.3",
     "axios": "^1.6.0",
+    "httpsnippet": "^3.0.9",
     "uuid": "10.0.0"
   },
   "devDependencies": {
@@ -41,4 +42,4 @@
     "mcp-insomnia": "./dist/index.js"
   },
   "packageManager": "yarn@1.22.22+sha512.a6b2f7906b721bba3d67d4aff083df04dad64c399707841b7acf00f6b133b7ac24255f2652fa22ae3534329dc6180534e98d17432037ff6fd140556e2bb3137e"
-}
+}

package/dist/.claude/settings.local.json

@@ -1,9 +0,0 @@
-{
-  "permissions": {
-    "allow": [
-      "Bash(npm --prefix .. run build)",
-      "Bash(npm:*)"
-    ],
-    "deny": []
-  }
-}