yamcp

Overview

YAMCP (YAM-C-P) is a command-line tool designed to organize and manage MCP servers as local workspaces. It allows users to create collections of MCP servers, both local and remote, and expose them as a unified gateway to AI applications. The tool supports grouping servers by functionality (e.g., coding, design) or by AI application (e.g., Cursor, Claude), making it easier to manage complex MCP setups. YAMCP provides a centralized logging system that consolidates all server communication logs, simplifying monitoring and debugging of MCP servers across different AI client applications.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• add_mcp_server

  Add a new MCP server to the configuration

  Try:Add a new MCP server for GitHub APITry:Add a local file system server
• list_mcp_servers

  List all configured MCP servers and their status

  Try:Show me all configured MCP serversTry:List servers with status
• remove_mcp_server

  Remove a configured MCP server

  Try:Remove the GitHub server from configurationTry:Delete server with name 'local-files'
• import_mcp_servers

  Import MCP server configurations from a JSON file

  Try:Import server configurations from backup.jsonTry:Load servers from my-servers.json
• create_workspace

  Create a new workspace to group MCP servers

  Try:Create a workspace for coding projectsTry:Make a design workspace with Figma server
• list_workspaces

  List all workspaces or show details of a specific workspace

  Try:Show all my workspacesTry:List details for the 'coding' workspace
• edit_workspace

  Modify an existing workspace configuration

  Try:Edit the 'design' workspace to add a new serverTry:Remove a server from my coding workspace
• scan_workspace

  Scan a workspace for available MCP servers

  Try:Scan the 'research' workspace for new serversTry:Check for updates in all workspaces
• delete_workspace

  Delete a workspace and its configuration

  Try:Delete the old workspaceTry:Remove the 'backup' workspace
• run_workspace

  Start the gateway with a specified workspace to expose MCP servers

  Try:Run the coding workspaceTry:Start the gateway for my design workspace
• view_logs

  View the server communication logs

  Try:Show me the MCP server logsTry:Display recent gateway activity

Comparable tools

Installation

# Install YAMCP globally
npm install -g yamcp

# Or use npx without installation
npx yamcp

{
  "mcpServers": {
    "yamcp": {
      "command": "npx",
      "args": ["yamcp", "run", "your-workspace-name"]
    }
  }
}

FAQ

What is a YAM workspace?

A YAM (Yet Another MCP) workspace is a collection of MCP servers grouped together and exposed through a unified gateway for AI applications to access.

How do I add a new MCP server to YAMCP?

Use the command `yamcp server add` to interactively add a new MCP server to your collection, or `yamcp server import` to import from a configuration file.

On Hacker News

Recent discussion from the developer community.

• Show HN: A Model Context Workspace Manager. Bundle Your MCPs in YAMs▲ 5💬 1
  Story by hamid_ra · 2025-04-29

Compare yamcp with