코드베이스를 기반으로 한 보다 기술적인 세부 정보가 포함된 향상된 README는 다음과 같습니다.

mcp-원격-서버

원격 구성에서 동적으로 기능을 로드하는 구성 가능한 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 서버는 ModelContextProtocol을 활용하여 로컬 MCP 클라이언트와 통신할 수 있는 로컬 서버를 생성합니다.

개요

mcp-remote-server MCP 클라이언트와 원격 API를 연결하는 브리지 역할을 합니다. MCP_CONTROL_PLANE_URL 통해 지정된 원격 호스팅 구성을 파싱합니다. 이 구성에는 도구, 리소스 및 프롬프트 목록이 포함되어 있으며, 각 목록은 원격 API 엔드포인트를 가리킵니다.

주요 특징

• 동적 구성 : 서버 기능은 원격 JSON 구성을 통해 정의됩니다.

• 자동 새로 고침 : 구성은 60초마다 자동으로 새로 고쳐집니다.

• 모든 MCP 기본형을 지원합니다 .

  • 도구: 원격 API 호출을 통해 작업 실행

  • 리소스: 원격 데이터를 읽을 수 있는 리소스로 노출

  • 프롬프트: 재사용 가능한 프롬프트 템플릿 정의

구성 형식

지엑스피1

핸들러 API 요구 사항

원격 핸들러는 적절한 형식의 응답을 반환해야 합니다.

• 도구 핸들러 : 문자열화되어 MCP 도구 응답으로 래핑되는 JSON을 반환합니다.

• 리소스 핸들러 : 지정된 mimeType과 일치하는 콘텐츠를 반환합니다.

• 프롬프트 핸들러 : 문자열(메시지에 자동으로 래핑됨) 또는 MCP 형식 메시지 배열을 반환합니다.

Related MCP server: MCP-YNU FastMCP Server

설치

bun install

용법

1. 제어 평면 URL을 설정하세요:

export MCP_CONTROL_PLANE_URL="https://your-config-endpoint"

2. 서버를 실행합니다:

bun run index.ts

제한 사항

• HTTP/HTTPS 핸들러 엔드포인트만 지원합니다.

• 구성은 HTTP GET 요청을 통해 접근 가능해야 합니다.

• 핸들러 응답은 JSON과 호환되어야 합니다.

• 로컬에서만 실행됩니다(표준 MCP 제한)

이 프로젝트는 bun v1.1.32에서 bun init 사용하여 만들어졌습니다. Bun 은 빠른 올인원 JavaScript 런타임입니다. 저는 Bun의 속도와 조금 다른 것을 시도해 보고 싶어서 Bun을 선택했습니다.

이 프로젝트에서도 타입 검사와 린팅에 Biome을 사용합니다. Bun과 같은 이유로 Biome을 선택했습니다. 뭔가 다른 것을 원했고, JS에 gofmt 같은 도구가 있었으면 좋았을 텐데요. 좋은 시작입니다.