YAMCP
A Model Context Workspace Manager. Oraganize your MCP servers in local workspaces (coding, design, research, ...), scan, monitor, and integrate each workspace with AI apps via a unified CLI.
What is YAMCP?
YAMCP is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to model context workspace manager. oraganize your mcp servers in local workspaces (coding, design, research, ...), scan, monitor, and integrate each workspace with ai apps via a unified cli.
A Model Context Workspace Manager. Oraganize your MCP servers in local workspaces (coding, design, research, ...), scan, monitor, and integrate each workspace with AI apps via a unified CLI.
This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- A Model Context Workspace Manager. Oraganize your MCP server
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx yamcpConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use YAMCP
YAMCP (Yet Another MCP) is a Model Context Workspace Manager that lets you organize your MCP servers into named workspaces — such as 'coding', 'research', or 'design' — and expose each workspace as a single unified MCP gateway to your AI applications. Instead of loading every MCP server for every task, you activate only the workspace relevant to your current work, reducing noise and improving AI focus. YAMCP manages both stdio and SSE-based MCP servers and provides centralized logging across all active servers.
Prerequisites
- Node.js 18 or later installed on your system
- npm 7 or later (included with Node.js 18+)
- One or more MCP servers already installed that you want to organize into workspaces
- An MCP-compatible client such as Claude Desktop or Claude Code
Install YAMCP globally
Install the yamcp package globally so the 'yamcp' CLI is available from any directory.
npm install -g yamcpImport your existing MCP server configurations
Import server definitions from your existing MCP config file, or add servers one by one using the CLI. YAMCP stores server configurations in its own config store.
# Import from an existing config file
yamcp server import ./my-mcp-config.json
# Or list currently known servers
yamcp server listCreate a workspace (YAM) and assign servers
Create a named workspace and add the MCP servers you want active in that context. For example, a 'coding' workspace might include filesystem, git, and a code search server.
# Create a new workspace interactively
yamcp yam create
# List all workspaces
yamcp yam listRun a workspace as an MCP server
Start a workspace gateway. YAMCP exposes all servers in the workspace as a single stdio MCP endpoint that your AI client can connect to.
yamcp run codingConfigure your AI client to use the YAMCP gateway
Point your Claude Desktop or other MCP client at the YAMCP gateway for the workspace you want to use. Each workspace gets its own command.
{
"mcpServers": {
"coding-workspace": {
"command": "yamcp",
"args": ["run", "coding"]
}
}
}YAMCP Examples
Client configuration
Claude Desktop config that uses YAMCP to run a named workspace, aggregating multiple MCP servers behind a single entry.
{
"mcpServers": {
"coding-workspace": {
"command": "yamcp",
"args": ["run", "coding"]
},
"research-workspace": {
"command": "yamcp",
"args": ["run", "research"]
}
}
}Prompts to try
YAMCP CLI commands and example AI assistant interactions for managing and using workspaces.
- Run 'yamcp server list' to see all registered MCP servers
- Run 'yamcp yam list' to see all defined workspaces
- Run 'yamcp run coding' to start the coding workspace gateway
- Run 'yamcp log' to view consolidated logs from all active servers
- Ask Claude: "What MCP tools are available in my current workspace?"
- Ask Claude: "Use the tools in this workspace to help me debug my TypeScript project"Troubleshooting YAMCP
yamcp command not found after npm install -g
Check that npm's global bin directory is on your PATH. Run 'npm bin -g' to find the global bin path and add it to your shell profile (e.g., export PATH="$(npm bin -g):$PATH" in ~/.zshrc). Reload your shell and try again.
A server in the workspace fails to start
Run 'yamcp log' to see consolidated error output from all servers. Each server logs with its name prefix. Identify the failing server and test it in isolation by running its command directly in a terminal. Fix its configuration before adding it to the workspace.
Tools from a workspace server do not appear in Claude
Verify the workspace is running by executing 'yamcp run <workspace-name>' in a terminal and checking for startup errors. Also confirm the args in claude_desktop_config.json match the exact workspace name as created (case-sensitive). Restart Claude Desktop after any config changes.
Frequently Asked Questions about YAMCP
What is YAMCP?
YAMCP is a Model Context Protocol (MCP) server that model context workspace manager. oraganize your mcp servers in local workspaces (coding, design, research, ...), scan, monitor, and integrate each workspace with ai apps via a unified cli. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install YAMCP?
Follow the installation instructions on the YAMCP GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with YAMCP?
YAMCP works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is YAMCP free to use?
Yes, YAMCP is open source and available under the Apache-2.0 license. You can use it freely in both personal and commercial projects.
YAMCP Alternatives — Similar Developer Tools Servers
Looking for alternatives to YAMCP? Here are other popular developer tools servers you can use with Claude, Cursor, and VS Code.
Ecc
★ 188.2kThe agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
Javaguide
★ 155.8kJava 面试 & 后端通用面试指南，覆盖计算机基础、数据库、分布式、高并发、系统设计与 AI 应用开发
Gemini CLI
★ 104.5kA secure MCP server that wraps the Google Gemini CLI, allowing clients to query Gemini models using local OAuth sessions without requiring an API key. It provides tools for model interaction and diagnostics with built-in protection against command in
Awesome MCP Servers
★ 87.3k⭐ Curated list of Model Context Protocol (MCP) servers - tools that extend Claude Desktop, Cursor, Windsurf, and other MCP clients with custom capabilities.
MCP Servers
★ 86.0kModel Context Protocol Servers
CC Switch
★ 77.5kA cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Gemini CLI & Hermes Agent. Only official website: ccswitch.io
Browse More Developer Tools MCP Servers
Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up YAMCP in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use YAMCP?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.