Skip to content
Back to search

mcp-server-metamcp

MCP Server MetaMCP manages all your other MCPs in one MCP.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/metatool-ai--mcp-server-metamcp/badge.svg)](/listings/metatool-ai--mcp-server-metamcp)

HTML

<a href="/listings/metatool-ai--mcp-server-metamcp"><img src="/api/listings/metatool-ai--mcp-server-metamcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Installing via Smithery

Sometimes Smithery works (confirmed in Windsurf locally) but sometimes it is unstable because MetaMCP is special that it runs other MCPs on top of it. Please consider using manual installation if it doesn't work instead.

To install MetaMCP MCP Server for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@metatool-ai/mcp-server-metamcp):

npx -y @smithery/cli install @metatool-ai/mcp-server-metamcp --client claude

Manual Installation

export METAMCP_API_KEY=<env>
npx -y @metamcp/mcp-server-metamcp@latest
{
  "mcpServers": {
    "MetaMCP": {
      "command": "npx",
      "args": ["-y", "@metamcp/mcp-server-metamcp@latest"],
      "env": {
        "METAMCP_API_KEY": "<your api key>"
      }
    }
  }
}

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 179 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # MetaMCP MCP Server
  2. > **🚨 DEPRECATED PACKAGE WARNING 🚨**
  3. >
  4. > This local proxy package is deprecated in MetaMCP's 2.0 all-in-one architecture.
  5. >
  6. > **Please checkout https://github.com/metatool-ai/metamcp for more details.**
  7. MetaMCP MCP Server is a proxy server that joins multiple MCP⁠ servers into one. It fetches tool/prompt/resource configurations from MetaMCP App⁠ and routes tool/prompt/resource requests to the correct underlying server.
  8. [![smithery badge](https://smithery.ai/badge/@metatool-ai/mcp-server-metamcp)](https://smithery.ai/server/@metatool-ai/mcp-server-metamcp)
  9. <a href="https://glama.ai/mcp/servers/0po36lc7i6">
  10. <img width="380" height="200" src="https://glama.ai/mcp/servers/0po36lc7i6/badge" alt="MetaServer MCP server" />
  11. </a>
  12. MetaMCP App repo: https://github.com/metatool-ai/metatool-app
  13. ## Installation
  14. ### Installing via Smithery
  15. Sometimes Smithery works (confirmed in Windsurf locally) but sometimes it is unstable because MetaMCP is special that it runs other MCPs on top of it. Please consider using manual installation if it doesn't work instead.
  16. To install MetaMCP MCP Server for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@metatool-ai/mcp-server-metamcp):
  17. ```bash
  18. npx -y @smithery/cli install @metatool-ai/mcp-server-metamcp --client claude
  19. ```
  20. ### Manual Installation
  21. ```bash
  22. export METAMCP_API_KEY=<env>
  23. npx -y @metamcp/mcp-server-metamcp@latest
  24. ```
  25. ```json
  26. {
  27. "mcpServers": {
  28. "MetaMCP": {
  29. "command": "npx",
  30. "args": ["-y", "@metamcp/mcp-server-metamcp@latest"],
  31. "env": {
  32. "METAMCP_API_KEY": "<your api key>"
  33. }
  34. }
  35. }
  36. }
  37. ```
  38. ## Usage
  39. ### Using as a stdio server (default)
  40. ```bash
  41. mcp-server-metamcp --metamcp-api-key <your-api-key>
  42. ```
  43. ### Using as an SSE server
  44. ```bash
  45. mcp-server-metamcp --metamcp-api-key <your-api-key> --transport sse --port 12006
  46. ```
  47. With the SSE transport option, the server will start an Express.js web server that listens for SSE connections on the `/sse` endpoint and accepts messages on the `/messages` endpoint.
  48. ### Using as a Streamable HTTP server
  49. ```bash
  50. mcp-server-metamcp --metamcp-api-key <your-api-key> --transport streamable-http --port 12006
  51. ```
  52. With the Streamable HTTP transport option, the server will start an Express.js web server that handles HTTP requests. You can optionally use `--stateless` mode for stateless operation.
  53. ### Using with Docker
  54. When running the server inside a Docker container and connecting to services on the host machine, use the `--use-docker-host` option to automatically transform localhost URLs:
  55. ```bash
  56. mcp-server-metamcp --metamcp-api-key <your-api-key> --transport sse --port 12006 --use-docker-host
  57. ```
  58. This will transform any localhost or 127.0.0.1 URLs to `host.docker.internal`, allowing the container to properly connect to services running on the host.
  59. ### Configuring stderr handling
  60. For STDIO transport, you can control how stderr is handled from child MCP processes:
  61. ```bash
  62. # Use inherit to see stderr output from child processes
  63. mcp-server-metamcp --metamcp-api-key <your-api-key> --stderr inherit
  64. # Use pipe to capture stderr (default is ignore)
  65. mcp-server-metamcp --metamcp-api-key <your-api-key> --stderr pipe
  66. # Or set via environment variable
  67. METAMCP_STDERR=inherit mcp-server-metamcp --metamcp-api-key <your-api-key>
  68. ```
  69. Available stderr options:
  70. - `ignore` (default): Ignore stderr output from child processes
  71. - `inherit`: Pass through stderr from child processes to the parent
  72. - `pipe`: Capture stderr in a pipe for processing
  73. - `overlapped`: Use overlapped I/O (Windows-specific)
  74. ### Command Line Options
  75. ```
  76. Options:
  77. --metamcp-api-key <key> API key for MetaMCP (can also be set via METAMCP_API_KEY env var)
  78. --metamcp-api-base-url <url> Base URL for MetaMCP API (can also be set via METAMCP_API_BASE_URL env var)
  79. --report Fetch all MCPs, initialize clients, and report tools to MetaMCP API
  80. --transport <type> Transport type to use (stdio, sse, or streamable-http) (default: "stdio")
  81. --port <port> Port to use for SSE or Streamable HTTP transport, defaults to 12006 (default: "12006")
  82. --require-api-auth Require API key in SSE or Streamable HTTP URL path
  83. --stateless Use stateless mode for Streamable HTTP transport
  84. --use-docker-host Transform localhost URLs to use host.docker.internal (can also be set via USE_DOCKER_HOST env var)
  85. --stderr <type> Stderr handling for STDIO transport (overlapped, pipe, ignore, inherit) (default: "ignore")
  86. -h, --help display help for command
  87. ```
  88. ## Environment Variables
  89. - `METAMCP_API_KEY`: API key for MetaMCP
  90. - `METAMCP_API_BASE_URL`: Base URL for MetaMCP API
  91. - `USE_DOCKER_HOST`: When set to "true", transforms localhost URLs to host.docker.internal for Docker compatibility
  92. - `METAMCP_STDERR`: Stderr handling for STDIO transport (overlapped, pipe, ignore, inherit). Defaults to "ignore"
  93. ## Development
  94. ```bash
  95. # Install dependencies
  96. npm install
  97. # Build the application
  98. npm run build
  99. # Watch for changes
  100. npm run watch
  101. ```
  102. ## Highlights
  103. - Compatible with ANY MCP Client
  104. - Multi-Workspaces layer enables you to switch to another set of MCP configs within one-click.
  105. - GUI dynamic updates of MCP configs.
  106. - Namespace isolation for joined MCPs.
  107. ## Architecture Overview
  108. ```mermaid
  109. sequenceDiagram
  110. participant MCPClient as MCP Client (e.g. Claude Desktop)
  111. participant MetaMCP-mcp-server as MetaMCP MCP Server
  112. participant MetaMCPApp as MetaMCP App
  113. participant MCPServers as Installed MCP Servers in Metatool App
  114. MCPClient ->> MetaMCP-mcp-server: Request list tools
  115. MetaMCP-mcp-server ->> MetaMCPApp: Get tools configuration & status
  116. MetaMCPApp ->> MetaMCP-mcp-server: Return tools configuration & status
  117. loop For each listed MCP Server
  118. MetaMCP-mcp-server ->> MCPServers: Request list_tools
  119. MCPServers ->> MetaMCP-mcp-server: Return list of tools
  120. end
  121. MetaMCP-mcp-server ->> MetaMCP-mcp-server: Aggregate tool lists
  122. MetaMCP-mcp-server ->> MCPClient: Return aggregated list of tools
  123. MCPClient ->> MetaMCP-mcp-server: Call tool
  124. MetaMCP-mcp-server ->> MCPServers: call_tool to target MCP Server
  125. MCPServers ->> MetaMCP-mcp-server: Return tool response
  126. MetaMCP-mcp-server ->> MCPClient: Return tool response
  127. ```
  128. ## Credits
  129. - Inspirations and some code (refactored in this project) from https://github.com/adamwattis/mcp-proxy-server/

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.