MCP-Insomnia는 Insomnia-compatible 형식으로 API 컬렉션을 만들고 관리 할 수있는 AI 에이전트를 가능하게하는 MCP (모델 Context Protocol) 서버입니다. 이 서버는 Insomnia에 수출 될 수있는 컬렉션, 요청 및 환경을 관리하기위한 도구를 제공합니다.

임명과 사용법

# 필수품

• 노드.js 18+
• npm 또는 원사

mcp-insomnia]를 사용하는 세 가지 방법이 있습니다.

##1. NPX로 실행 (추천)

글로벌 설치 없이 mcp-insomnia] npx]를 직접 실행할 수 있습니다.

** 구성:**

##2. NPM에서 글로벌 설치

npm을 사용하여 전 세계적으로 패키지를 설치하십시오.

설치:

** 구성:**

##3. 소스에서 설치

저장소를 복제하고 프로젝트를 구축합니다.

설치:

** 구성:**

사용 가능한 도구

컬렉션 관리

• create_collection - 새로운 컬렉션/작업공간 만들기
• list_collections - 모든 컬렉션 목록
• get_collection_detail - 수집의 전체 세부사항과 통계를 얻으십시오
• export_collection - JSON 형식으로 내보내기

폴더 관리

• create_folder - 수집 내 폴더 만들기

요청 관리

• list_requests - 모든 요청 목록, 선택적으로 수집 필터

MCP-Insomnia

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 for managing collections, requests, and environments that can be exported to Insomnia.

Installation and Usage

Prerequisites

• Node.js 18+
• npm or yarn

There are three ways to use mcp-insomnia.

1. Run with NPX (Recommended)

You can run mcp-insomnia directly using npx without a global installation.

Configuration:

{
  "mcpServers": {
    "insomnia": {
      "command": "npx",
      "args": ["-y", "mcp-insomnia"]
    }
  }
}

2. Install Globally from NPM

Install the package globally using npm.

Installation:

npm install -g mcp-insomnia

Configuration:

{
  "mcpServers": {
    "insomnia": {
      "command": "mcp-insomnia"
    }
  }
}

3. Install from Source

Clone the repository and build the project.

Installation:

git clone https://github.com/anggasct/mcp-insomnia.git
cd mcp-insomnia
npm install
npm run build

Configuration:

{
  "mcpServers": {
    "insomnia": {
      "command": "node",
      "args": ["/path/to/mcp-insomnia/dist/index.js"]
    }
  }
}

Available Tools

Collection Management

• create_collection - Create new collection/workspace
• list_collections - List all collections
• get_collection_detail - Get full details and statistics of a collection
• export_collection - Export collection to JSON format

Folder Management

• create_folder - Create folder within collection

Request Management

• list_requests - List all requests, optionally filter by collection
• get_request - Get full details of a specific request
• create_request_in_collection - Create new request
• update_request - Update existing request
• delete_request - Delete request
• execute_request - Execute an MCP-stored request and return the response (supports environment resolution, timeouts, and response size limits — see Request execution)
• get_request_history - Get execution history of a request (up to 20 entries per request)

Import Tools

• import_from_curl - Parse cURL command into a request
• import_from_postman - Import Postman Collection (v2.1) JSON
• import_from_openapi - Import OpenAPI 3.x or Swagger 2.x JSON
• import_from_insomnia_export - Import collections from a standard Insomnia V4 export file

Utility Tools

• generate_code_snippet - Generate a code snippet for a request. Requires requestId and target. Supported targets: c, clojure, csharp, go, http, java, javascript, kotlin, node, objc, ocaml, php, powershell, python, ruby, shell, swift. Optional client selects a library (e.g. axios for javascript, curl for shell).

Insomnia Direct Integration (NeDB)