MCP-Insomnia は、AI エージェントが Insomnia 互換フォーマットで API コレクションを作成および管理できる MCP (Model Context Protocol) サーバーです。 このサーバーは、Insomniaにエクスポートできるコレクション、リクエスト、および環境を管理するためのツールを提供します。

インストールと使用

前提条件

• Node.js 18 +
• npmかヤーン

[mcp-insomniaを使う3つの方法があります。

##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)