AI Collaboration MCP Server
A streamlined Model Context Protocol (MCP) server that provides enhanced AI collaboration tools for VS Code with automatic project context injection and conversation history.
🚀 Features
Multi-Provider Support: Claude, GPT-4, Gemini, and Ollama
Workspace-Specific Conversation History: Each project gets isolated conversation memory
Automatic Context Injection: Project files, structure, and README automatically included
Dynamic Workspace Management: Switch between projects seamlessly
API Call Management: Rate limiting (3 calls per provider per hour)
Streamlined Tools: Just 4 essential tools that work together
🛠️ Tools Available
1. #set_workspace
Set the current workspace directory for project-specific conversation history and context.
Usage in VS Code:
2. #consult_ai
Get expert advice from a specific AI provider with full project context.
Usage in VS Code:
3. #multi_ai_research
Get perspectives from multiple AI providers on complex questions.
Usage in VS Code:
4. #mandatory_execute
Force tool execution with explicit commands.
Usage in VS Code:
📦 Installation
Prerequisites
Node.js 18+
VS Code with MCP support
API keys for desired AI providers
1. Clone and Setup
2. Configure Environment Variables
Create a .env
file:
3. Build the Server
4. Configure VS Code MCP
Option A: Workspace-specific (recommended for testing)
Create .vscode/mcp.json
in your project:
Option B: Global configuration (for all projects)
Create ~/.vscode/mcp.json
:
5. Enable MCP Auto-start (Optional)
Add to your VS Code settings.json
:
🎯 Usage
First Time Setup Per Project:
Restart VS Code after configuration
Open VS Code chat (sidebar or
Cmd+Shift+I
)Set workspace for your project:
@workspace use #set_workspace with workspace_path="/full/path/to/your/project"
Daily Usage:
Use the AI tools:
@workspace use #consult_ai with claude about my code
@workspace use #multi_ai_research to compare approaches
@workspace !consult_ai
(force execution)
When Switching Projects:
Set new workspace:
@workspace use #set_workspace with workspace_path="/path/to/other/project"
💡 Tip: Each project gets its own .mcp-conversation-history.json
file for isolated conversation memory.
⚠️ Important Syntax Note
When using @workspace
in VS Code, MCP tool names must be prefixed with #
:
✅ Correct: @workspace use #consult_ai with claude about my code
❌ Wrong: @workspace use consult_ai with claude about my code
Without @workspace
, no #
is needed:
✅ Also correct: use consult_ai with claude about my code
🔧 Development
Run in Development Mode
Test the Server
Debug with MCP Inspector
🧠 How It Works
Enhanced Context Injection
Every tool call automatically includes:
Project structure and files
README and package.json content
Relevant conversation history
Current workspace context
Conversation History
Persistent file-based history (
.mcp-conversation-history.json
)Smart relevance filtering
Cross-session context continuity
API Management
Rate limiting per provider (3 calls/hour)
Automatic retry with exponential backoff
Clear error handling and user feedback
🔒 Security Notes
API keys are stored in MCP configuration (keep them secure)
Conversation history is stored locally
No data sent to external services except AI provider APIs
🤝 Contributing
Fork the repository
Create a feature branch
Make your changes
Test thoroughly
Submit a pull request
📄 License
MIT License - see LICENSE file for details
🆘 Troubleshooting
MCP Server Won't Start
Check
Cmd+Shift+P
→ "MCP: List Servers"Verify file paths in configuration
Check VS Code Output panel for errors
Ensure Node.js and dependencies are installed
API Keys Not Working
Verify keys are correctly set in MCP configuration
Check for typos or extra spaces
Ensure keys have proper permissions
Tools Not Appearing
Restart VS Code completely
Try
@workspace
in chat to trigger MCP loadingCheck MCP server logs for errors
🌟 Why This Approach?
This streamlined server demonstrates that smart consolidation beats feature proliferation:
3 core tools instead of 7+ specialized ones
Enhanced context shared across all tools
Easier maintenance and debugging
Better user experience with consistent functionality
Reduced cognitive load - focus on what you want, not which tool to use
Perfect for teams wanting powerful AI collaboration without complexity!
This server cannot be installed
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
Enables collaboration with multiple AI providers (Claude, GPT-4, Gemini, Ollama) directly from VS Code with automatic project context injection and persistent conversation history. Provides streamlined tools for getting AI advice, multi-provider research, and enhanced context sharing across sessions.