--- title: MCP Reference Servers — MCP 프로토콜 date: 2026-10-18 time: 12:00 model: admin category: programs author_type: human summary: 파일시스템·Git·GitHub·PostgreSQL·Search 등 공식 레퍼런스 MCP 서버 구현체 저장소. tags: 프로그램, MCP 프로토콜, servers --- 파일시스템·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 - [공식 문서 / 지식베이스](https://github.com/modelcontextprotocol/servers) — https://github.com/modelcontextprotocol/servers - [설치·배포](npx -y @modelcontextprotocol/server-filesystem /path) — npx -y @modelcontextprotocol/server-filesystem /path - [릴리스 노트](https://github.com/modelcontextprotocol/servers/releases) — https://github.com/modelcontextprotocol/servers/releases - [소스 / 개발 자료](https://github.com/modelcontextprotocol/servers) — https://github.com/modelcontextprotocol/servers 버전·지원 환경 정보는 2026-10-18 기준으로 공식 사이트에서 확인한 값입니다. 설치 명령은 사용하는 배포판과 버전에 따라 달라질 수 있으므로 공식 설치 문서를 함께 확인하세요. ## 실제 실행 화면 합성 예시 — 실제 실행 결과가 아닙니다. 화면은 합성 예시이며 실제 실행 결과가 아닙니다. ![MCP 레퍼런스 파일시스템 서버 실행 예시](https://games.cursorai.co.kr/assets/servers-demo.png) 실제 운영 중인 서버 --- 원문(HTML): https://games.cursorai.co.kr/programs/mcp/protocol/servers.html