Enables searching and managing Docker setup documentation and configuration files
Enhances GitHub Copilot with workspace awareness, context-aware code suggestions, and smart configuration management based on project documentation and settings
Enables searching and reading Markdown documentation files in workspaces
Provides search capabilities for MDX documentation files
Built on Node.js runtime for executing the MCP server functionality
Uses npm for dependency management and build scripts
Integrates with Prettier for code formatting in development workflows
Enables searching and managing Python-related configuration settings, including interpreter paths and VS Code Python settings
Provides tools for reading and updating TOML configuration files
Built with TypeScript support including import resolution, path aliases, and strict type checking
Enables reading, updating, and searching YAML configuration files
Config MCP Server
An MCP (Model Context Protocol) server providing developer documentation search, configuration helpers, and settings search tools for AI assistants and development workflows.
Features
š Documentation Search
searchDocs: Search markdown, MDX, and text files in your workspace
Supports custom glob patterns for targeted searches
Perfect for finding documentation, README files, and guides
āļø Configuration Management
getConfig: Read configuration files (JSON/JSONC/YAML/TOML)
setConfig: Update configuration files safely with dot-notation key paths
listConfigs: Discover all configuration files in your workspace
šļø Settings Search
searchSettings: Search through JSON/JSONC settings files
Ideal for VS Code settings, application configs, and more
Customizable file patterns for different types of settings
Requirements
Node.js 18.17+ (20+ recommended)
MCP-compatible client (Claude Desktop, Continue.dev, etc.)
Installation & Setup
1. Install Dependencies
2. Build the Server
3. Install VS Code MCP Extension (Recommended)
For the best experience with GitHub Copilot, install the MCP extension for VS Code:
Open VS Code
Go to Extensions (Ctrl/Cmd + Shift + X)
Search for "Model Context Protocol" or "MCP"
Install the official MCP extension
Reload VS Code
4. Configure Your MCP Client
Add to your MCP client configuration:
VS Code with GitHub Copilot (.vscode/settings.json
):
VS Code User Settings (settings.json
):
Claude Desktop (claude_desktop_config.json
):
Continue.dev (.continue/config.json
):
Development Scripts
npm run dev
ā Start in watch mode (supports .ts imports)npm run build
ā Compile TypeScript todist/
npm start
ā Run compiled servernpm run lint
ā Check code stylenpm run format
ā Format code with Prettier
Tool Reference
searchDocs
Search developer documentation and markdown files.
searchSettings
Search configuration and settings files for specific keys or values.
getConfig
Read and parse configuration files with optional key extraction.
setConfig
Update configuration files safely with automatic format detection.
listConfigs
Discover configuration files in the workspace.
Supported File Formats
JSON (
.json
) - Standard JSON filesJSONC (
.jsonc
) - JSON with comments (VS Code style)YAML (
.yaml
,.yml
) - YAML configuration filesTOML (
.toml
) - TOML configuration filesMarkdown (
.md
,.mdx
) - Documentation filesText (
.txt
) - Plain text files
Error Handling
All tools include comprehensive error handling and return user-friendly error messages when:
Files are not found or unreadable
Invalid JSON/YAML/TOML syntax
Permission issues
Invalid key paths or values
TypeScript Support
The server is built with TypeScript and supports:
Import resolution with
.ts
extensions in developmentPath aliases (
@/lib/...
) for cleaner importsStrict type checking for reliability
Source maps for debugging
GitHub Copilot Integration
Enhanced Copilot Experience
With this MCP server, GitHub Copilot gains powerful workspace awareness:
Context-Aware Suggestions: Copilot can reference your project's documentation and configuration
Smart Configuration: Automatically suggests configuration changes based on your project setup
Workspace Understanding: Better code completions using your project's README and docs
VS Code Features
Workspace Integration: Automatically detects when you're working in a configured workspace
Command Palette: Access MCP tools via VS Code Command Palette (
Ctrl/Cmd + Shift + P
)Status Bar: Shows MCP server connection status
Output Panel: View MCP server logs in VS Code Output panel
Usage Examples
In VS Code with GitHub Copilot
Chat with Copilot:
"@workspace Search for authentication setup in our docs"
"Help me find where the API configuration is defined"
"What's the current database timeout setting?"
"Update the dev server port to 3001"
Command Palette Integration
Press
Ctrl/Cmd + Shift + P
Type "MCP: Config" to see available commands:
MCP: Search Documentation
MCP: Find Settings
MCP: Read Configuration
MCP: Update Configuration
MCP: List Config Files
Traditional Examples
Finding Documentation
Ask your AI: "Search for Docker setup instructions"
ā Uses searchDocs
to find relevant documentation
Managing Configuration
Ask your AI: "Update the database port to 5433 in my config file"
ā Uses getConfig
to read current config, then setConfig
to update it
Exploring Settings
Ask your AI: "Show me all my VS Code Python settings"
ā Uses searchSettings
to find Python-related configuration
VS Code & Copilot Troubleshooting
Common Issues
MCP Server Not Starting:
Check VS Code Output panel (
View > Output > Model Context Protocol
)Verify Node.js is installed and accessible in PATH
Ensure the server path in settings.json is correct
Try reloading VS Code (
Ctrl/Cmd + Shift + P > Developer: Reload Window
)
Copilot Not Using MCP Context:
Verify GitHub Copilot extension is installed and active
Check that
github.copilot.advanced.mcp.enabled
is set totrue
Restart VS Code after configuration changes
Use
@workspace
prefix in Copilot chat for explicit context
Performance Optimization:
Adjust
maxResults
in settings if searches are slowUse more specific glob patterns in
include
parametersAdd common build directories to search exclusions
VS Code Tips
Quick Access: Use
Ctrl/Cmd + Shift + P
then type "MCP" to see all available commandsStatus Monitoring: Check the status bar for MCP connection indicators
Workspace Templates: Copy
.vscode/settings.json.template
to your project's.vscode/settings.json
Global vs Workspace: Use User settings for global MCP config, Workspace settings for project-specific setup
GitHub Copilot Best Practices
Start questions with
@workspace
to engage MCP contextBe specific about file types: "search TypeScript configs" vs "search configs"
Use natural language: "What's my current database setup?" instead of technical queries
Leverage context: Copilot will automatically use your project's documentation in suggestions
Contributing
Fork the repository
Create a feature branch
Make your changes
Run
npm run lint
andnpm run format
Test with VS Code MCP integration
Submit a pull request
License
MIT - See LICENSE file for details
This server cannot be installed
local-only server
The server can only run on the client's local machine because it depends on local resources.
Enables AI assistants to search documentation, read and update configuration files, and discover settings across your development workspace. Supports JSON, YAML, TOML, and Markdown files with seamless integration for GitHub Copilot and other MCP clients.