mcp-remote-server

Name: mcp-remote-server
Author: sirmews

@sirmews

代码仓库

关于 mcp-remote-server

A declarative, composable model context protocol server that uses a remote config

#mcp-remote-server #model-context-protocol #remote-config

基本信息

分类

其他

传输方式

stdio

发布者

sirmews

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "mcp-remote-server": {
      "command": "bun",
      "args": [
        "run",
        "index.ts"
      ]
    }
  }
}

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

What is mcp-remote-server?

A configurable Model Context Protocol (MCP) server that dynamically loads its capabilities from a remote configuration. It acts as a bridge between MCP clients and remote APIs by parsing a hosted JSON configuration defining tools, resources, and prompts.

How to use mcp-remote-server?

Install with bun install, set the MCP_CONTROL_PLANE_URL environment variable to your configuration endpoint, then run bun run index.ts.

Key features of mcp-remote-server?

Dynamic configuration loaded from a remote JSON endpoint
Configuration auto-refreshes every 60 seconds
Supports tools, resources, and prompts as MCP primitives
Handlers are remote HTTP/HTTPS API endpoints
Handler responses must be JSON-compatible

Use cases of mcp-remote-server

—

FAQ from mcp-remote-server

How does mcp-remote-server load its capabilities?

It fetches a JSON configuration from the URL specified in the MCP_CONTROL_PLANE_URL environment variable. The configuration lists tools, resources, and prompts, each with a remote handler endpoint.

What are the handler API requirements?

Tool handlers must return JSON that the server wraps in an MCP tool response. Resource handlers must return content matching the specified mimeType. Prompt handlers can return either a string (wrapped in a message) or an array of MCP-formatted messages.

What are the limitations of mcp-remote-server?

Only HTTP/HTTPS handler endpoints are supported. The configuration must be accessible via HTTP GET. Handler responses must be JSON-compatible. The server runs locally only (standard MCP limitation).