MCP Reference Servers — MCP 프로토콜

MCP·Skill / MCP 프로토콜 / servers.html

MCP 프로토콜원문등록 2026-10-18

파일시스템·Git·GitHub 등 공식 레퍼런스 MCP 서버 모음

기본 정보

프로그램 이름	MCP Reference Servers (MCP 레퍼런스 서버)
한 줄 소개	파일시스템·Git·GitHub 등 공식 레퍼런스 MCP 서버 모음
개발·유지	Model Context Protocol 프로젝트
공식 홈페이지	https://github.com/modelcontextprotocol/servers
공식 문서	https://github.com/modelcontextprotocol/servers
설치·배포	npx -y @modelcontextprotocol/server-filesystem /path
동작 환경	MCP 호스트 앱 (Claude Desktop, Cursor, opencode 등)
라이선스	MIT 라이선스 (대부분)
안정 버전	GitHub main 브랜치 (2026-10-13 push) — 확인일 2026-10-18
GitHub 저장소	https://github.com/modelcontextprotocol/servers
분류	MCP 프로토콜 (태그: MCP, 레퍼런스, 서버, 파일시스템, GitHub)

이 프로그램은 무엇인가?

MCP Reference Servers는 Model Context Protocol 공식 저장소에 있는 레퍼런스 서버 구현체 모음입니다. 파일시스템 접근, Git 저장소 작업, GitHub 이슈·PR 관리, PostgreSQL 질의, 웹 검색 등 자주 쓰이는 기능을 MCP 서버로 미리 만들어 두었습니다.

각 서버는 TypeScript·Python SDK로 구현되어 있으며, npx·uvx 한 줄로 실행할 수 있습니다. MCP 호스트 앱(Claude Desktop·Cursor 등)의 설정 파일에 등록하면 바로 사용할 수 있습니다. 90,000개 이상의 GitHub stars를 받은 가장 널리 참조되는 MCP 저장소입니다.

어떤 문제를 해결하는가?

MCP 서버를 처음 만들어보는 데 참고할 예제가 필요한 상황
파일시스템·GitHub·DB 등 표준 기능을 빠르게 연결해야 하는 상황
서버 설정 JSON 형식을 정확히 알고 싶은 상황

주요 기능

파일시스템 서버

허용된 경로의 파일 읽기·쓰기·탐색

활용 상황: 에이전트가 프로젝트 파일 작업
얻는 결과: 읽기·쓰기·검색 도구 제공
제한 사항: 경로 권한을 반드시 제한해야 함

GitHub 서버

이슈·PR·저장소 관리 도구 제공

활용 상황: 에이전트로 코딩 워크플로 자동화
얻는 결과: 이슈 생성·리뷰·머지 지원
제한 사항: GitHub 토큰 설정 필요

Git·PostgreSQL 서버

Git 명령 질의·DB 조회 도구

활용 상황: 코드 저장소·DB를 에이전트에 연결
얻는 결과: 읽기 위주 안전 설정 권장
제한 사항: 쓰기 권한은 신중히 부여

설정 예제

mcp.json 형식의 연결 설정을 그대로 제공

활용 상황: 호스트 앱 설정 즉시 복사
얻는 결과: stdio·원격 전송 예제 포함
제한 사항: 클라이언트별 설정 위치가 다름

설치 및 실행

npx (TypeScript 서버)

npx로 파일시스템 서버를 실행합니다.

npx -y @modelcontextprotocol/server-filesystem /path/to/allowed

uvx (Python 서버)

uvx로 Git 서버를 실행합니다.

uvx mcp-server-git --repository /path/to/repo

호스트 앱 설정

Claude Desktop·Cursor의 mcp.json에 서버를 등록합니다.

{"mcpServers":{"filesystem":{"command":"npx","args":["-y","@modelcontextprotocol/server-filesystem","/path"]}}}

실제 사용 예제

파일시스템 서버 실행

허용 경로를 지정해 서버를 실행합니다.

npx -y @modelcontextprotocol/server-filesystem /home/user/project

호스트 앱에 등록

mcp.json 설정에 서버 항목을 추가하고 앱을 재시작합니다.

Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json

도구 목록 확인

Inspector로 연결해 노출된 도구를 확인합니다.

npx @modelcontextprotocol/inspector npx -y @modelcontextprotocol/server-filesystem /tmp

장점과 한계

장점

공식 프로젝트, 90k+ stars로 가장 검증된 MCP 저장소
표준 기능을 npx·uvx 한 줄로 실행
mcp.json 설정 예제를 그대로 복사 가능
TypeScript·Python SDK 두 가지 구현 제공

사용 전에 고려할 점

파일시스템 서버의 경로 설정을 잘못하면 보안 위험
GitHub 서버는 토큰·권한 관리 필요
일부 서버는 레거시 사양 기준일 수 있음

비슷한 프로그램과 비교

프로그램	특징	이런 경우에 적합
커뮤니티 서버 (mcp.so·Smithery)	수만 개의 서브셋 서버 목록	특수 서비스 연결
직접 구현	필요한 도구만 SDK로 직접 작성	사내 도구 노출
호스트 앱 내장 도구	Cursor·Claude Desktop 기본 도구	별도 서버 없이 기본 기능

공식 자료 및 추가 학습

공식 홈페이지 — https://github.com/modelcontextprotocol/servers
공식 문서 / 지식베이스 — https://github.com/modelcontextprotocol/servers
설치·배포 — npx -y @modelcontextprotocol/server-filesystem /path
릴리스 노트 — https://github.com/modelcontextprotocol/servers/releases
소스 / 개발 자료 — https://github.com/modelcontextprotocol/servers

버전·지원 환경 정보는 2026-10-18 기준으로 공식 사이트에서 확인한 값입니다. 설치 명령은 사용하는 배포판과 버전에 따라 달라질 수 있으므로 공식 설치 문서를 함께 확인하세요.

실제 실행 화면

합성 예시 — 실제 실행 결과가 아닙니다. 화면은 합성 예시이며 실제 실행 결과가 아닙니다.

MCP 레퍼런스 파일시스템 서버 실행 예시

실제 운영 중인 서버

이 문서는 화면 표시용 가상 디렉터리의 항목입니다. 실제 서버 파일시스템과 연결되지 않으며, 파일 실행이나 시스템 명령을 수행하지 않습니다.