이 저장소는 두 가지 보완 구성 요소의 조합입니다.

사이트맵 Registry는 여러 MCP (Model Context Protocol) 서버를 관리하고 좌표하는 서버 솔루션입니다. 그것은 제공합니다:

• MCP 서버에 대한 중앙 등록
• 동적 포트 할당
• 등록된 서버의 건강 모니터링
• 모든 등록된 서버의 도구에 대한 통합 접근

FastMCP-HTTP는 MCP의 HTTP REST 클라이언트 서버 솔루션을 제공하는 Python 패키지입니다. HTTP 엔드포인트를 통해 도구, 프롬프트 및 리소스에 대한 통합 인터페이스를 제공합니다.

부품

HTTP 서버

FastMCPHttpServer는 MCP의 HTTP 서버 솔루션을 제공합니다.

HTTP 클라이언트

FastMCPHttpClient는 FastMCP 서버와 상호 작용하는 동시 인터페이스를 모두 제공합니다. 또한 MCP 레지스트리 서버에 클라이언트로 기능에 확장됩니다.

레지스트리 서버

MCP Registry Server는 여러 MCP 서버를 위한 중앙 코디네이터 역할을 합니다. 서버 등록, 건강 모니터링을 처리하고 연결된 모든 서버의 액세스 도구에 통합 된 인터페이스를 제공합니다.

MCP 탐색기

MCP Explorer는 MCP 서버와 도구와 상호 작용하는 그래픽 사용자 인터페이스를 제공합니다.

설치

MCP Registry & FastMCP-HTTP

This repository is a combination of two complementary components.

MCP Registry is a server solution that manages and coordinates multiple MCP (Model Context Protocol) servers. It provides:

• Central registration for MCP servers
• Dynamic port allocation
• Health monitoring of registered servers
• Unified access to tools across all registered servers

FastMCP-HTTP is a Python package that provides an HTTP REST client-server solution for MCP. It offers a unified interface for accessing tools, prompts and resources through HTTP endpoints.

Components

HTTP Server

The FastMCPHttpServer provides an HTTP server solution for MCP.

HTTP Client

The FastMCPHttpClient offers both synchronous and asynchronous interfaces to interact with FastMCP servers. It is extended to also function as a client to the MCP registry server.

Registry Server

The MCP Registry Server acts as a central coordinator for multiple MCP servers. It handles server registration, health monitoring, and provides a unified interface to access tools across all connected servers.

MCP Explorer

The MCP Explorer provides a graphical user interface for interacting with MCP servers and their tools.

Installation

1. Clone the repository
2. Install the dependencies:

pip install -r requirements.txt

Examples

Using the registry server

FastMCPHttpServer

from fastmcp_http.server import FastMCPHttpServer

mcp = FastMCPHttpServer("MyServer", description="My MCP Server")

@mcp.tool()
def my_tool(text: str) -> str:
    return f"Processed: {text}"

if __name__ == "__main__":
    mcp.run_http()

FastMCPHttpClient

from fastmcp_http.client import FastMCPHttpClient

def main():
    # Connect to the registry server
    client = FastMCPHttpClient("http://127.0.0.1:31337")

    servers = client.list_servers()
    print(servers)

    tools = client.list_tools()
    print(tools)

    result = client.call_tool("my_tool", {"text": "Hello, World!"})
    print(result)

if __name__ == "__main__":
    main()

Standalone

FastMCPHttpServer

from fastmcp_http.server import FastMCPHttpServer

mcp = FastMCPHttpServer("MyServer", description="My MCP Server")

@mcp.tool()
def my_tool(text: str) -> str:
    return f"Processed: {text}"

if __name__ == "__main__":
    mcp.run_http(register_server=False, port=15151)

FastMCPHttpClient

from fastmcp_http.client import FastMCPHttpClient

def main():
    client = FastMCPHttpClient("http://127.0.0.1:15151")

    tools = client.list_tools()
    print(tools)

    result = client.call_tool("my_tool", {"text": "Hello, World!"})
    print(result)

if __name__ == "__main__":
    main()

Usage

1. Start the MCP Registry (start_registry_server.py)
2. Start an MCP server (and verify that it is properly registered in the registry)
3. Start a client and connect to the registry url

License

MIT License