starred/hoppscotch

Fork

You've already forked hoppscotch

mirror of https://github.com/hoppscotch/hoppscotch.git synced 2026-04-25 08:45:58 +03:00

Code Issues 711 Projects Releases 5 Packages Wiki Activity

[PR #5965] feat(realtime): add Model Context Protocol (MCP) client support #5437

New issue

Open

opened 2026-03-17 02:52:57 +03:00 by kerem · 0 comments

kerem commented

2026-03-17 02:52:57 +03:00

Owner

Copy link

📋 Pull Request Information

Original PR: https://github.com/hoppscotch/hoppscotch/pull/5965
Author: @rahulbsw
Created: 3/9/2026
Status: 🔄 Open

Base: main ← Head: feat/mcp-client-support

📝 Commits (10+)

ec97a96 feat(realtime): add Model Context Protocol (MCP) client support
addbe8f docs(mcp): add comprehensive tests and documentation
6494089 docs(mcp): add local testing guide with Playwright examples
3cd04ea refactor(mcp): move MCP to separate sidebar navigation
ce36e26 fix(mcp): replace HoppSmartSelect with HoppButtonSecondary
40a0d75 fix(mcp): address critical PR review issues
87240e0 feat(mcp): add server catalog for quick connections
9313e80 fix(mcp): address PR review issues from cubic-dev-ai
fd5e4a4 fix(mcp): address additional PR review issues
5e90944 fix(mcp): address remaining PR review issues

📊 Changes

32 files changed (+5410 additions, -78 deletions)

View changed files

➕ packages/hoppscotch-common/assets/icons/mcp.svg (+1 -0)
📝 packages/hoppscotch-common/locales/en.json (+53 -0)
📝 packages/hoppscotch-common/src/components.d.ts (+14 -0)
📝 packages/hoppscotch-common/src/components/app/Sidenav.vue (+7 -0)
➕ packages/hoppscotch-common/src/components/collections/mcp/Add.vue (+93 -0)
➕ packages/hoppscotch-common/src/components/collections/mcp/Edit.vue (+104 -0)
➕ packages/hoppscotch-common/src/components/collections/mcp/index.vue (+184 -0)
➕ packages/hoppscotch-common/src/components/history/mcp/Card.vue (+122 -0)
➕ packages/hoppscotch-common/src/components/mcp/Configuration.vue (+220 -0)
➕ packages/hoppscotch-common/src/components/mcp/EnvVarsList.vue (+176 -0)
➕ packages/hoppscotch-common/src/components/mcp/HTTPAuth.vue (+206 -0)
➕ packages/hoppscotch-common/src/components/mcp/MethodCard.vue (+164 -0)
➕ packages/hoppscotch-common/src/components/mcp/PromptsList.vue (+103 -0)
➕ packages/hoppscotch-common/src/components/mcp/ResourcesList.vue (+122 -0)
➕ packages/hoppscotch-common/src/components/mcp/ServerCard.vue (+105 -0)
➕ packages/hoppscotch-common/src/components/mcp/ServerCatalog.vue (+136 -0)
➕ packages/hoppscotch-common/src/components/mcp/ToolsList.vue (+99 -0)
➕ packages/hoppscotch-common/src/helpers/mcp/servers.ts (+249 -0)
➕ packages/hoppscotch-common/src/helpers/realtime/MCPConnection.ts (+86 -0)
➕ packages/hoppscotch-common/src/helpers/realtime/MCPHTTPConnection.ts (+335 -0)

...and 12 more files

📄 Description

Summary

Adds comprehensive Model Context Protocol (MCP) client support to Hoppscotch, similar to Postman's implementation. This enables users to connect to MCP servers, discover capabilities (tools, prompts, resources), and invoke methods with JSON arguments.

Closes #5966

Key Features:

✅ HTTP and STDIO transport support
✅ Multiple authentication methods (Basic, Bearer, API Key, None)
✅ Automatic capability discovery
✅ Tool/prompt/resource invocation with JSON editor
✅ Real-time event logging and connection status
✅ Collections support for saving MCP requests
✅ History tracking for method invocations
✅ Search/filter across capabilities
✅ Full i18n support

Technical Implementation

Data Layer:

Versioned schema in @hoppscotch/data using verzod pattern
HoppMCPRequest type with transport configs and auth
Schema validation with Zod

Connection Layer:

Abstract MCPConnection base class
MCPHTTPConnection - JSON-RPC 2.0 over HTTP/SSE
MCPSTDIOConnection - Process-based transport (requires Agent/Desktop)
Event-driven architecture with RxJS

State Management:

MCPSession store with 20+ dispatchers
Observable streams for reactive UI updates
Integration with existing collections/history stores

UI Components:

12 Vue 3 composition API components
Configuration, Tools, Prompts, Resources, Logs, Response tabs
Modal dialogs for collections/history
Real-time connection status indicators

Integration:

New /realtime/mcp route
Tab in realtime navigation alongside WebSocket, SSE, Socket.io, MQTT
Follows existing Hoppscotch architectural patterns

Files Changed

23 new files (~3,600 lines):
- 3 data schema files (packages/hoppscotch-data/src/mcp/)
- 3 connection helper files (packages/hoppscotch-common/src/helpers/realtime/)
- 1 session store (packages/hoppscotch-common/src/newstore/MCPSession.ts)
- 13 Vue components (packages/hoppscotch-common/src/components/mcp/)
- 1 main page (packages/hoppscotch-common/src/pages/realtime/mcp.vue)
- i18n translations
5 modified files:
- packages/hoppscotch-common/src/newstore/collections.ts - MCP collections support
- packages/hoppscotch-common/src/newstore/history.ts - MCP history tracking
- packages/hoppscotch-common/src/pages/realtime.vue - Navigation entry
- packages/hoppscotch-common/locales/en.json - i18n strings
- pnpm-lock.yaml - No new dependencies

Test Plan

Zero linting errors (eslint --fix)
Zero TypeScript errors (vue-tsc --noEmit)
All pre-commit hooks pass
Manual testing:
- HTTP transport connection
- STDIO transport (requires Agent)
- Capability discovery (tools, prompts, resources)
- Method invocation with various JSON arguments
- Authentication methods (Basic, Bearer, API Key)
- Save to collections
- History tracking
- Search/filter functionality
- Real-time event logging
- UI responsiveness

Reference

Implementation based on Postman's MCP support and the Model Context Protocol specification.

_{🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.}

## 📋 Pull Request Information **Original PR:** https://github.com/hoppscotch/hoppscotch/pull/5965 **Author:** [@rahulbsw](https://github.com/rahulbsw) **Created:** 3/9/2026 **Status:** 🔄 Open **Base:** `main` ← **Head:** `feat/mcp-client-support` --- ### 📝 Commits (10+) - [`ec97a96`](https://github.com/hoppscotch/hoppscotch/commit/ec97a9624571a022bcbd1d60342df1c93bc11f5f) feat(realtime): add Model Context Protocol (MCP) client support - [`addbe8f`](https://github.com/hoppscotch/hoppscotch/commit/addbe8f38bb83174c103fb7cbf040c0d105272ec) docs(mcp): add comprehensive tests and documentation - [`6494089`](https://github.com/hoppscotch/hoppscotch/commit/6494089e7dc3b6002e6c8ae26f69ff1433a9b155) docs(mcp): add local testing guide with Playwright examples - [`3cd04ea`](https://github.com/hoppscotch/hoppscotch/commit/3cd04ea2a188306629b02c19c258f856989ae25f) refactor(mcp): move MCP to separate sidebar navigation - [`ce36e26`](https://github.com/hoppscotch/hoppscotch/commit/ce36e26dcdc47e7b78f2769c6e9065bca2bda33b) fix(mcp): replace HoppSmartSelect with HoppButtonSecondary - [`40a0d75`](https://github.com/hoppscotch/hoppscotch/commit/40a0d750163699faf7b701421586826058d12ca2) fix(mcp): address critical PR review issues - [`87240e0`](https://github.com/hoppscotch/hoppscotch/commit/87240e09c36e9070f9576f41468cb72b91d0b4a2) feat(mcp): add server catalog for quick connections - [`9313e80`](https://github.com/hoppscotch/hoppscotch/commit/9313e80e1e696fa6c688cf6356225d429e8bbfd4) fix(mcp): address PR review issues from cubic-dev-ai - [`fd5e4a4`](https://github.com/hoppscotch/hoppscotch/commit/fd5e4a4164bf941adf9f5ded415e20acb8444809) fix(mcp): address additional PR review issues - [`5e90944`](https://github.com/hoppscotch/hoppscotch/commit/5e9094456b6dcd3c206b5abbf34eea7129011261) fix(mcp): address remaining PR review issues ### 📊 Changes **32 files changed** (+5410 additions, -78 deletions) <details> <summary>View changed files</summary> ➕ `packages/hoppscotch-common/assets/icons/mcp.svg` (+1 -0) 📝 `packages/hoppscotch-common/locales/en.json` (+53 -0) 📝 `packages/hoppscotch-common/src/components.d.ts` (+14 -0) 📝 `packages/hoppscotch-common/src/components/app/Sidenav.vue` (+7 -0) ➕ `packages/hoppscotch-common/src/components/collections/mcp/Add.vue` (+93 -0) ➕ `packages/hoppscotch-common/src/components/collections/mcp/Edit.vue` (+104 -0) ➕ `packages/hoppscotch-common/src/components/collections/mcp/index.vue` (+184 -0) ➕ `packages/hoppscotch-common/src/components/history/mcp/Card.vue` (+122 -0) ➕ `packages/hoppscotch-common/src/components/mcp/Configuration.vue` (+220 -0) ➕ `packages/hoppscotch-common/src/components/mcp/EnvVarsList.vue` (+176 -0) ➕ `packages/hoppscotch-common/src/components/mcp/HTTPAuth.vue` (+206 -0) ➕ `packages/hoppscotch-common/src/components/mcp/MethodCard.vue` (+164 -0) ➕ `packages/hoppscotch-common/src/components/mcp/PromptsList.vue` (+103 -0) ➕ `packages/hoppscotch-common/src/components/mcp/ResourcesList.vue` (+122 -0) ➕ `packages/hoppscotch-common/src/components/mcp/ServerCard.vue` (+105 -0) ➕ `packages/hoppscotch-common/src/components/mcp/ServerCatalog.vue` (+136 -0) ➕ `packages/hoppscotch-common/src/components/mcp/ToolsList.vue` (+99 -0) ➕ `packages/hoppscotch-common/src/helpers/mcp/servers.ts` (+249 -0) ➕ `packages/hoppscotch-common/src/helpers/realtime/MCPConnection.ts` (+86 -0) ➕ `packages/hoppscotch-common/src/helpers/realtime/MCPHTTPConnection.ts` (+335 -0) _...and 12 more files_ </details> ### 📄 Description ## Summary Adds comprehensive Model Context Protocol (MCP) client support to Hoppscotch, similar to Postman's implementation. This enables users to connect to MCP servers, discover capabilities (tools, prompts, resources), and invoke methods with JSON arguments. **Closes #5966** **Key Features:** - ✅ HTTP and STDIO transport support - ✅ Multiple authentication methods (Basic, Bearer, API Key, None) - ✅ Automatic capability discovery - ✅ Tool/prompt/resource invocation with JSON editor - ✅ Real-time event logging and connection status - ✅ Collections support for saving MCP requests - ✅ History tracking for method invocations - ✅ Search/filter across capabilities - ✅ Full i18n support ## Technical Implementation **Data Layer:** - Versioned schema in `@hoppscotch/data` using verzod pattern - `HoppMCPRequest` type with transport configs and auth - Schema validation with Zod **Connection Layer:** - Abstract `MCPConnection` base class - `MCPHTTPConnection` - JSON-RPC 2.0 over HTTP/SSE - `MCPSTDIOConnection` - Process-based transport (requires Agent/Desktop) - Event-driven architecture with RxJS **State Management:** - `MCPSession` store with 20+ dispatchers - Observable streams for reactive UI updates - Integration with existing collections/history stores **UI Components:** - 12 Vue 3 composition API components - Configuration, Tools, Prompts, Resources, Logs, Response tabs - Modal dialogs for collections/history - Real-time connection status indicators **Integration:** - New `/realtime/mcp` route - Tab in realtime navigation alongside WebSocket, SSE, Socket.io, MQTT - Follows existing Hoppscotch architectural patterns ## Files Changed - **23 new files** (~3,600 lines): - 3 data schema files (`packages/hoppscotch-data/src/mcp/`) - 3 connection helper files (`packages/hoppscotch-common/src/helpers/realtime/`) - 1 session store (`packages/hoppscotch-common/src/newstore/MCPSession.ts`) - 13 Vue components (`packages/hoppscotch-common/src/components/mcp/`) - 1 main page (`packages/hoppscotch-common/src/pages/realtime/mcp.vue`) - i18n translations - **5 modified files**: - `packages/hoppscotch-common/src/newstore/collections.ts` - MCP collections support - `packages/hoppscotch-common/src/newstore/history.ts` - MCP history tracking - `packages/hoppscotch-common/src/pages/realtime.vue` - Navigation entry - `packages/hoppscotch-common/locales/en.json` - i18n strings - `pnpm-lock.yaml` - No new dependencies ## Test Plan - [x] Zero linting errors (`eslint --fix`) - [x] Zero TypeScript errors (`vue-tsc --noEmit`) - [x] All pre-commit hooks pass - [x] Manual testing: - [x] HTTP transport connection - [ ] STDIO transport (requires Agent) - [x] Capability discovery (tools, prompts, resources) - [x] Method invocation with various JSON arguments - [ ] Authentication methods (Basic, Bearer, API Key) - [ ] Save to collections - [x] History tracking - [ ] Search/filter functionality - [ ] Real-time event logging - [x] UI responsiveness ## Reference Implementation based on [Postman's MCP support](https://learning.postman.com/docs/postman-ai/mcp-requests/create) and the [Model Context Protocol specification](https://modelcontextprotocol.io/). --- <sub>🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.</sub>

kerem added the

pull-request

label

2026-03-17 02:52:57 +03:00

No Branch/Tag specified

main

chore/security-fix-2026-4-0

fix/mockserver-env-set-url-priority

feat/rest-gql-merge

refactor/workspaces

fix/onboarding-mass-assignment

desktop-settings-phase-0-schema-bridge-shell

patch

test-webhook

pr/johnan319/5745

tembo/optimize-performance-db-queries

add-claude-github-actions-1772782423108

fix/code-scanning-103

fix/mock-server-example-endpoint-match-v2

fix/rate-limit-on-health-route

hotfix/api-doc-collection-deletetion

cd-test

fix/mock-server-backend-followup

chore/code-scanning-52

chore/verion-addition-check

nested-migrations

scripting-system-updates-worker-setup

scripting-system-updates

pr/shipko/4367

ci-test

feat/user-delete-condition

feat/user-workspace-stats-api

chore/collection-export-addition

fix/import-file-size-limit-flow

feat/dashboard-common

feat/sort-environment-alphabetically

feat/infra-config-encryption

refactor/team

feat/collection-duplicationn

feat/secure-cookies-toggle

pr/pavog/4195

pr/pavog/4196

test/patch-demo

feat/native-interceptor-updates

pr/AndrewBastin/4111

feat/user-last-active-on

fix/codemirror-large-text-scroll-bug

fix/precision-lost-beautify

fix/env-diff-test-schema-error

fix/email-case-sensitive

release/2024.3.3

refactor/workspace-login-conversion

feat/node-apline-version-upgrade

feat/seed

release/2024.3.2

fix/sh-email-handlebar-issue

feat/app-experiment-animation

release/2024.3.1

release/2024.3.0

pr/jamesgeorge007/3937

experiment/deploychan

feat/github-enterprise-auth

refactor/collection-search-query

hotfix/infra-config-reset-bug

fix/secret-var-bug

hotfix/full-text-search

hotfix/request-variable-version-syncing

feat/request-variable

feat/server-config-additional-properties

pr/JoelJacobStephen/3845

release/2023.12.6

fix/safari-codemirror-perf-bug

release/2023.12.5

release/2023.12.4

fix/secret-env-bugs-tooltip

release/2023.12.3

fix/shared-request-bug

fix/disable-context-menu-option

release/2023.12.2

release/2023.12.1

fix/shared-request-bugs

release/2023.12.0

fix/gql-history-schema

fix/actions-not-working-without-sidebar

pr/jamesgeorge007/3665

chore/desktop-app-corrections

fix/auth-headers-in-coll

fix/embed-url

improve/placeholder

add-realtime-logos

feat/shared-request-embeds

feat/collection-headers

revamp/header

release/2023.8.4

refactor/interceptor-error-display

feat/subpath-based-access

release/2023.8.3

feat/shared-requests

feat/desktop

fix/nodemailer-templates-issue

feature/upgrade-graphql-ws

fix/graphql-crashing

fix/set-environments-when-no-env-selected

refactor/pre-prisma-bump-setup

release/2023.8.2

pr/danitherex/3216

perf/raw-db-query

release/2023.8.1

revert-3348-perf/reduce-backend-calls

fix/incorrect-tab-count-close-all-tab

fix/duplicate-tab-bug

release/2023.8.0

hotfix/fetch-shortcode

fix/tab-right-click-rename-bug

chore/docker-fixes

pr/JoelJacobStephen/3178

feat/fe-accessible-auth-provider-env

feat-cherry-pick/conditional-auth-select

feat/conditional-auth-select

release/2023.4.8

fix/generate-sitemap-issue

test/backend-test-case

refactor/team-invitation

pr/AndrewBastin/3171

release/2023.4.7

fix/duplicate-team-invite

fix/unified-bg-color-coll-tree

fix/shortcode-screen-stuck

release/2023.4.6

revert-3117-patch-3

fix/env-selector-bg

fix/db-url

release/2023.4.4

fix/sync-popup-bug

fix/team-env-set-test

chore/wss-to-ws-on-env

fix/prettify-xml-response

feat/db-volume-addition

feat/env-selector-tabs-ui

bug/broken-env

release/2023.4.2

fix/switch-workspace-env-bug

fix/magic-link

fix/cookie-handler

HPS-OSS-1

staging

revert/auth-issue

feat/export-env

refactor/commons

reference/path-variables

orphan-pr/2243

feat/realtime-search

fix/save-override

refactor/strategies

feat/embeds

bug/withDefaults

feat/show-keys

refactor/toast

2026.3.1

2026.3.0

2026.2.1

2026.2.0

2026.1.1

2026.1.0

2025.12.1

2025.12.0

2025.11.2

2025.11.1

2025.11.0

2025.10.1

2025.10.0

2025.9.2

2025.9.1

2025.9.0

2025.8.1

2025.8.0

2025.7.1

2025.7.0

2025.6.1

2025.6.0

2025.5.4

2025.5.3

2025.5.2

2025.5.1

2025.5.0

2025.4.2

2025.4.1

2025.4.0

2025.3.2

2025.3.1

2025.3.0

2025.2.3

2025.2.2

2025.2.1

2025.2.0

2025.1.1

2025.1.0

2024.12.2

2024.12.1

2024.12.0

2024.11.0

2024.10.2

2024.10.1

2024.10.0

2024.9.3

2024.9.2

2024.9.1

2024.9.0

2024.8.3

2024.8.2

2024.8.1

2024.8.0

2024.7.2

2024.7.1

2024.7.0

2024.6.1

2024.6.0

2024.3.4

2024.3.3

2024.3.2

2024.3.1

2024.3.0

2023.12.6

2023.12.5

2023.12.4

2023.12.3

2023.12.2

2023.12.1

2023.12.0

2023.8.4

2023.8.3

2023.8.2

2023.8.1

2023.8.0

2023.4.8

2023.4.7

2023.4.6

2023.4.5

2023.4.4

2023.4.3

2023.4.2

2023.4.1

2023.4.0

v3.0.1

v3.0.0

v2.2.1

v2.2.0

v2.1.0

v2.0.0

v1.12.0

v1.10.0

v1.9.9

v1.9.7

v1.9.5

v1.9.0

v1.8.0

v1.5.0

v1.0.0

v0.1.0

Labels

Clear labels

not applicable to hoppscotch

not reproducible

pull-request

Mirrored from GitHub Pull Request

No labels

not applicable to hoppscotch

Milestone

Clear milestone

No items

No milestone

Projects

Clear projects

No items

No project

Assignees

Clear assignees

No assignees

1 participant

Notifications

Due date

The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference

starred/hoppscotch#5437

Reference in a new issue

Repository

starred/hoppscotch

Title

Body

No description provided.

Delete branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?

Rows
Columns