Integrated MCP Server

MCP Tools Documentation

A VSCode/Cursor extension that provides an integrated MCP server and UI panel for retrieving and displaying command-line tool documentation. The extension automatically detects tools in your workspace and provides their documentation through a WebView panel.

Core Features

🔄 Built-in MCP Server
- Express + SSE server (ports 54321-54421)
- Secure origin validation
- Automatic port selection
- Connection management and cleanup
- Real-time event streaming
🔍 Tool Discovery
- Package scripts (npm, yarn, pnpm)
- Local binaries (node_modules/.bin)
- Global tools (git, npm, yarn, pnpm)
- Monorepo workspace support
📚 Documentation Retrieval
- Help command execution (-h, --help)
- Version information fetching
- Secure command validation
- Error handling
💻 VS Code Integration
- React-based WebView panel
- Status bar integration
- Command palette support
- Workspace path detection

Architecture

1. VS Code Extension (Backend)

Extension Host (src/extension.ts)
├── Activates when VS Code starts
├── Creates MCP Server
│   └── Express + SSE Server (54321-54421 port range)
└── Creates WebView Panel

2. MCP Server (Middle Layer)

MCP Server (src/server/*)
├── SSE Event Stream
│   ├── Real-time tool discovery updates
│   ├── Documentation streaming
│   └── Connection state management
│
└── Tool Discovery System
    ├── path-scanner.ts
    │   └── Finds tools in workspace (bin/, node_modules/.bin)
    └── package-scanner.ts
        └── Scans package.json for available tools

3. WebView Panel (Frontend)

React WebView (src/panel/*)
├── UI Components
│   └── Shows available tools and their docs
│
└── SSE Client
    ├── Requests available tools
    └── Streams tool documentation

Project Structure

my-tools-mcp/
├── src/                      # Source code
│   ├── extension.ts          # Extension entry point
│   ├── env.ts               # Environment configuration
│   ├── server/              # Built-in MCP server
│   │   ├── index.ts         # Server setup and SSE handling
│   │   └── controllers/     # Tool discovery and execution
│   │       ├── docs/        # Documentation controllers
│   │       ├── path-scanner.ts    # Tool discovery
│   │       └── package-scanner.ts # Package.json scanning
│   ├── panel/              # WebView UI (React)
│   │   ├── index.tsx      # WebView entry point
│   │   ├── App.tsx        # Main React component
│   │   └── components/    # UI components
│   ├── types/             # Shared TypeScript types
│   └── lib/               # Shared utilities
├── dist/                  # Compiled output
└── src/__tests__/        # Test files

Development Setup

Install dependencies:

pnpm install

Start development:

# Start webpack in watch mode
pnpm run dev

# Or build for production
pnpm run build

Launch the extension:

Press F5 in VSCode to start debugging
The extension will start both the MCP server and WebView panel

Usage

Open the command palette (Cmd/Ctrl + Shift + P)
Type "MCP Tools" and select the command
The WebView panel will open and display available tools
Select a tool to view its documentation

Technical Details

Tool Discovery

Package Scripts
- Automatically detects npm/yarn/pnpm scripts
- Shows script source and working directory
- Supports monorepo workspaces
- Validates script existence
Binary Tools
- Finds tools in node_modules/.bin
- Detects global tools (git, npm, yarn, pnpm)
- Validates tool existence and permissions
- Handles path resolution

Documentation Retrieval

Executes help commands (-h, --help)
Fetches version information
Handles command execution errors
Validates tool names and arguments
Implements proper timeouts

SSE Communication

Real-time tool discovery updates
Secure origin validation
Connection management and cleanup
Error handling and reporting
Automatic reconnection support
Event-based streaming
Bi-directional message passing

Security Features

Tool name validation
Command injection prevention
Origin validation for SSE connections
Proper error handling and reporting
Resource cleanup
Connection state management

Testing

The extension includes comprehensive tests:

Integration tests for server functionality
VS Code extension tests
Tool discovery tests
Security validation tests
SSE communication tests

License

ISC

This server cannot be installed

security - not tested

license - not found

quality - not tested

local-only server

The server can only run on the client's local machine because it depends on local resources.

Facilitates real-time tool discovery and documentation retrieval for command-line tools within a VSCode extension, using Express and SSE for secure and dynamic content streaming.

Related Resources

Reddit Discussion about this server

Related MCP Servers

File Finder MCP Server
sergey-fintech
A
security
F
license
A
quality
Enables searching for files by name fragments via JSON-RPC or an HTTP REST API, with options for direct use or integration with other tools like VS Code.
Last updated -
1
JavaScript
Bifrost VSCode Devtools
biegehydra
-
security
A
license
-
quality
A VS Code extension provides a MCP server that exposes Roslyn language features. It enables tools like find usages, go to definition, quick info, etc.
Last updated -
81
TypeScript
AGPL 3.0
Notion Knowledge Base MCP Server
rickydata-indexer
-
security
F
license
-
quality
An MCP server that connects to your Notion knowledge base, allowing you to query and retrieve information directly from VSCode using the Cline extension.
Last updated -
Python
Confluence Wiki MCP Server
WindieChai
-
security
-
license
-
quality
Enables VSCode/Cursor to integrate with Confluence Wiki, allowing AI models to access and process wiki content by fetching pages and converting them to Markdown format.
Last updated -
2
TypeScript
MIT License

View all related MCP servers