IRM MCP Extension
Connects GitHub Copilot Chat to the IRM MCP Server for access to:
- IRM Knowledge Base (MediaWiki)
- IRM Git repositories
Installation
Copy this folder to your VS Code extensions directory:
%USERPROFILE%\.vscode\extensions\irm-mcp-1.0.0\
Restart VS Code
Check the "IRM MCP" output channel to verify connection
Configuration
Open VS Code settings and configure:
irmMcp.serverUrl: URL of the IRM MCP server (default: https://demo.irmnet.de/sse)irmMcp.clientId: OAuth client ID (default: github-copilot-irm)irmMcp.clientSecret: OAuth client secret (required, no default; set in Settings)irmMcp.enableAutoReconnect: Automatically reconnect when server restarts (default: true)
Usage
Once activated, the extension connects to the IRM MCP server in the background. GitHub Copilot Chat can then use IRM tools automatically during conversations.
Commands
- IRM MCP: Show Status - Check the current connection status
- IRM MCP: Restart MCP Server - Manually restart the connection to the MCP server
Auto-Reconnect Feature
The extension automatically monitors the connection and attempts to reconnect if the MCP server restarts:
- Uses exponential backoff strategy (2s, 4s, 8s, 16s, 32s)
- Maximum of 5 automatic reconnection attempts
- After max attempts, prompts user to manually restart
- Can be disabled via
irmMcp.enableAutoReconnect setting
If you need to reconnect immediately, use the "IRM MCP: Restart MCP Server" command.
Requirements
- Node.js and npm installed
- Network access to demo.irmnet.de
- Valid OAuth credentials configured (clientId and clientSecret provided by your server admin; no hardcoded defaults)
Development
Building & Packaging
# Compile TypeScript
npm run compile
# Build extension package
npm run package
Running Tests
npm test
Watch Mode
npm run test:watch
Changelog & Version Management
This project uses automated changelog and version management:
# Add a changelog entry (for agents/developers)
npm run changelog:add "Your change description" -- --type=added|changed|fixed|removed
# Bump version (creates new CHANGELOG section)
npm run version:patch # 1.0.4 -> 1.0.5 (bug fixes)
npm run version:minor # 1.0.4 -> 1.1.0 (new features)
npm run version:major # 1.0.4 -> 2.0.0 (breaking changes)
See docs/CHANGELOG_GUIDE.md for detailed instructions.
Test Coverage
The extension includes a comprehensive test suite covering:
- Platform detection (Windows vs non-Windows)
- Extension activation and configuration
- MCP server connection spawning
- Error handling and edge cases
- Extension deactivation and cleanup
