yamcp

YAMCP (YAM-C-P) is a command-line tool for organizing and managing MCP servers as local workspaces. It seamlessly connects to multiple MCP servers, local or remote, grouping them into a unified workspace exposed as Yet Another MCP server (YAM) for AI applications. You can create dedicated workspaces based on specific functionality (e.g., a YAM workspace for coding, design, research, ...) or based on the AI apps that consume servers (e.g., a YAM for Cursor, Claude, Windsurf) or any other combination in between. In addition, it simplifies monitoring and debugging MCP servers by centralizing all server communication logs in a single store, eliminating the need to dig through each AI client app’s logs separately.
Import and Create Workspaces
Connect All Bundled Servers in a Workspace to Your AI Apps with One Config
🚀 Quick Start
🔑 Key Concepts
- **MCP Servers**: Remote or local servers that provide Model Context Protocol services
- **Workspaces (YAMs)**: Collections of MCP servers grouped together to be shared with AI Apps (e.g. a workspace for coding, writing, design, magic making!)
- **Gateway**: A local MCP server that manages connections to configured MCP servers in a workspace and exposes them through a unified server to AI App's MCP clients
With YAMCP, you can:
- Create workspaces to group MCP servers by AI application (e.g. Cursor, Claude, GitHub Copilot)
- Group servers by workflow purpose (e.g. software development, data science, technical writing)
- Connect AI apps to a single gateway that provides access to all workspace servers
- Manage and monitor multiple MCP server connections through a unified interface
- Track all server communications with detailed logging and debugging capabilities
Top-Level Commands
Available top-level commands:
- server - Manage MCP providers
- yam - Manage workspaces (yams)
- run - Run the gateway with a workspace
- log - View the server log location
---
🔧 **Mcp Server Management Commands**
Server Commands
---
🍠 **Yam Workspace Management Commands**
Workspace Commands
Runtime Commands
---
✅ Command Reference
| Command | Description | Example |
| ----------------- | ----------------------- | ------------------------------------ |
| server add | Add a new MCP server | yamcp server add |
| server list | List configured servers | yamcp server list |
| server remove | Remove a server | yamcp server remove [name] |
| server import | Import server config | yamcp server import [config] |
| yam create | Create workspace | yamcp yam create |
| yam list | List workspaces | yamcp yam list |
| yam list --name | Show workspace details | yamcp yam list --name my-workspace |
| yam edit | Edit workspace | yamcp yam edit |
| yam scan | Scan workspace | yamcp yam scan [workspace-name] |
| yam delete | Delete workspace | yamcp yam delete [workspace-name] |