GitHub MCP 레지스트리를 사용하여 MCP 서버를 찾고, 설치하고, 관리하는 방법
이것을 상상해보세요: 당신이 식료품점에 들어갔는데 아무 것도 이해가 되지 않습니다. 시리얼은 세 개의 통로에 흩어져 있습니다. 셀프 체크아웃 근처의 임의의 쿨러에 우유가 숨겨져 있습니다. 그리고 라벨을 생산합니까? 몇 달 동안 업데이트되지 않았습니다.
이것이 바로 MCP(Model Context Protocol) 서버를 발견하는 느낌이었습니다. 지금까지.
다시 말하면 MCP는 개발자가 도구, API 및 워크플로를 AI 시스템에 연결하는 방법입니다. 각 MCP 서버는 브라우저 자동화를 위한 Playwright, 지식 액세스를 위한 Notion, 100개가 넘는 도구를 갖춘 GitHub의 자체 MCP 서버 등 AI 스택의 구성 요소와 같습니다.
새로운 GitHub MCP 레지스트리는 GitHub에서 바로 MCP 서버를 검색, 설치 및 관리할 수 있는 단일 표준 소스를 제공하여 모든 것을 변경합니다.
AI 스택에 적합한 도구를 찾고, 자체 서버를 게시하고, 팀을 위한 거버넌스를 설정하는 방법에 대해 알아야 할 사항은 다음과 같습니다.
이 블로그에서는 다음 방법을 안내합니다.
- MCP 서버 설치
- 나만의 게시
- 거버넌스 및 팀 사용 활성화
또한 파워 유저를 위한 몇 가지 팁과 요령도 공유하겠습니다. 갑시다!
오늘 레지스트리에는 무엇이 있습니까?
현재 GitHub MCP 레지스트리에는 MCP 서버 44개포함:
- 극작가: 웹 앱을 자동화하고 테스트합니다.
- GitHub MCP 서버: 100개 이상의 GitHub API 도구에 액세스하세요.
- 컨텍스트7, 마크잇다운 (마이크로소프트), 테라폼 (하시코프).
- 파트너 서버 노션(Notion), 유니티(Unity), 파이어크롤(Firecrawl), 스트라이프(Stripe), 그리고 더.
태그, 인기도 또는 GitHub 스타별로 탐색하여 필요한 도구를 찾을 수 있습니다.
MCP 서버를 설치하는 방법
레지스트리를 사용하면 원클릭으로 설치할 수 있습니다. VS 코드 또는 VS 코드 내부자.
예: 극작가 설치
- GitHub MCP 레지스트리에서 Playwright MCP 서버로 이동합니다.
- 딸깍 하는 소리 VS Code에 설치.
- VS Code는 미리 채워진 구성으로 시작됩니다.
- 선택적 매개변수(예: 저장 경로)를 수락하거나 조정합니다.
그게 다야. 에이전트 워크플로에서 Playwright를 사용할 준비가 되었습니다.
✅ 팁: GitHub와 같은 원격 MCP 서버는 설치 중에 OAuth를 사용하므로 토큰이나 비밀을 수동으로 처리할 필요가 없습니다. 한 번만 인증하고 구축을 시작하세요.
자신의 MCP 서버를 게시하는 방법
1. MCP 게시자 CLI 설치
- macOS/Linux/WSL(Homebrew, 권장):
brew install mcp-publisher- macOS/Linux/WSL(사전 빌드된 바이너리, 최신 버전):
" -s | tr '[:upper:]' '[:lower:]')_$(uname -m | sed 's/x86_64/amd64/;s/aarch64/arm64/').tar.gz" | tar xz mcp-publisher && sudo mv mcp-publisher /usr/local/bin/2. 초기화 server.json 파일
서버의 소스 디렉터리로 이동하여 다음을 실행합니다.
cd /path/to/your/mcp-server
mcp-publisher init이것은 server.json 파일. 예:
{
"$schema": "
"name": "io.github.yourname/your-server",
"title": "Describe Your Server",
"description": "A description of your MCP server",
"version": "1.0.0",
"packages": [
{
"registryType": "npm",
"identifier": "your-package-name",
"version": "1.0.0",
"transport": { "type": "stdio" }
}
]
}3. 귀하가 패키지를 소유하고 있음을 증명하십시오.
패키지 유형에 필요한 메타데이터를 추가합니다.
- NPM: 추가
"mcpName"필드를 귀하의package.json:
{
"name": "your-npm-package",
"mcpName": "io.github.username/server-name"
}- PyPI/NuGet: README에 다음을 추가하세요.
mcp-name: io.github.username/server-name- 도커: Dockerfile에 라벨을 추가합니다.
LABEL io.modelcontextprotocol.server.name="io.github.username/server-name"4. 인증
- GitHub 기반 네임스페이스의 경우(
io.github.*), 달리다:
mcp-publisher login githubOAuth 로그인을 위한 브라우저가 열립니다.
- 사용자 정의 도메인의 경우(
com.yourcompany/*), 공식 문서의 DNS 확인 단계를 따르세요.
5. 서버 게시
인증되면 레지스트리에 게시합니다.
mcp-publisher publish성공하면 MCP 레지스트리에서 서버를 검색할 수 있습니다. 다음을 통해 확인할 수 있습니다.
curl "위의 단계를 완료한 후 [email protected]으로 이메일을 보내 서버가 포함되도록 요청하세요.
✅ 전문가의 팁:
- 네임스페이스: 사용
io.github.username/*GitHub 인증의 경우 또는com.yourcompany/*DNS 기반 검증을 위해. - 원격 엔드포인트: 추가
"remotes"당신의 배열server.json클라우드/HTTP 엔드포인트의 경우:
"remotes": [
{
"type": "streamable-http",
"url": "
}
]GitHub Actions로 게시 자동화
태그가 지정된 모든 릴리스가 패키지 레지스트리와 MCP 레지스트리 모두에 게시되도록 게시를 자동화할 수 있습니다.
만들다 .github/workflows/publish-mcp.yml:
name: Publish to MCP Registry
on:
push:
tags: ["v*"]
jobs:
publish:
runs-on: ubuntu-latest
permissions:
id-token: write # For OIDC
contents: read
steps:
- uses: actions/checkout@v5
# (Edit these for your package type)
- name: Setup Node.js
uses: actions/setup-node@v5
with:
node-version: "lts/*"
- name: Install dependencies
run: npm ci
- name: Build and test
run: |
npm run build --if-present
npm run test --if-present
- name: Publish to npm
run: npm publish
env:
NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
# MCP publishing (works for all package types)
- name: Download MCP Publisher
run: |
curl -L " -s | tr '[:upper:]' '[:lower:]')_$(uname -m | sed 's/x86_64/amd64/;s/aarch64/arm64/').tar.gz" | tar xz mcp-publisher
- name: Publish to MCP Registry
run: |
./mcp-publisher login github-oidc
./mcp-publisher publish
# Optional: keep server.json version in sync with git tag
- run: |
VERSION=${GITHUB_REF#refs/tags/v}
jq --arg v "$VERSION" '.version = $v' server.json > tmp && mv tmp server.json워크플로를 트리거하려면 다음 안내를 따르세요.
git tag v1.0.0
git push origin v1.0.0게시하면 서버가 오픈 소스 레지스트리에 표시되고 다운스트림 레지스트리(예: GitHub)는 자동으로 업데이트를 선택합니다. 더 이상 새 버전을 출시할 때마다 수십 개의 다른 레지스트리에 알릴 필요가 없습니다.
✅ 전문가의 팁:
- 코드를 호스팅하세요. 공개 GitHub 저장소 확인된 소유권을 표시합니다.
- 태그 추가
server.json따라서 개발자는 카테고리별로 서버를 쉽게 찾을 수 있습니다. - 업데이트가 다운스트림에 자동으로 전파되므로 수동 알림이 필요하지 않습니다.
기업에서 MCP 서버를 관리하는 방법
대규모 조직 전체에서 MCP 사용량을 관리하는 경우 거버넌스는 선택 사항이 아닙니다. 개발자가 설치할 수 있는 서버를 제어해야 합니다. 특히 해당 서버가 민감한 데이터와 상호 작용하는 경우에는 더욱 그렇습니다.
GitHub는 이제 지원합니다 레지스트리 허용 목록 따라서 관리자는 개발자가 사용할 수 있는 MCP 서버를 제어할 수 있습니다.
관리자(귀하일 수도 있음)를 위한 단계는 다음과 같습니다.
- MCP API 사양(레지스트리 + HTTP 엔드포인트)을 따르는 내부 레지스트리를 시작하거나 연결합니다.
- 검증된 MCP 서버(내부 + 외부)를 레지스트리에 추가합니다.
- GitHub Enterprise 설정이 해당 레지스트리 끝점을 가리키도록 합니다.
- MCP 인식 표면(VS Code로 시작)은 허용 목록을 자동으로 적용합니다.
예: 허용 목록 작동 방식
내부 레지스트리 보고:
{
"servers": [
{
"name": "github.com/github/mcp-server",
"version": "1.0.0"
},
{
"name": "github.com/microsoft/markitdown-mcp",
"version": "2.1.0"
},
{
"name": "internal.mybank.com/mcp-servers/custom-tools",
"version": "1.5.0"
}
]
}개발자가 VS Code에 MCP 서버를 설치하려고 하면 GitHub는 레지스트리 끝점을 확인하고 승인된 목록에서만 설치를 허용합니다.
이 거버넌스 모델은 개발자에게 필요한 도구에 대한 액세스 권한을 제공하는 동시에 파트너십을 조사하고, 보안 검사를 실행하고, 규정 준수를 유지할 수 있음을 의미합니다.
✅ 팁: 허용 목록에 추가하기 전에 GitHub의 API 또는 기존 보안 파이프라인을 사용하여 MCP 서버를 조사하세요.
고급 사용자를 위한 팁과 요령
기본 사항을 숙지한 후 레지스트리를 최대한 활용할 수 있는 몇 가지 바로 가기는 다음과 같습니다.
- 더 똑똑하게 정렬하세요: GitHub 스타 및 조직 확인을 사용하여 품질과 적법성을 신속하게 평가합니다. 서버에 수천 개의 별이 있고 Microsoft 또는 HashiCorp와 같은 검증된 조직에서 제공되는 경우 이는 강력한 신호입니다.
- 현지 테스트: MCP Inspector를 사용하여 게시하기 전에 MCP 서버를 테스트하세요. 이렇게 하면 레지스트리를 오염시키지 않고 문제를 조기에 발견하는 데 도움이 됩니다.
- 에이전트 시너지: Copilot 코딩 에이전트는 GitHub 및 Playwright MCP 서버와 함께 사전 로드되어 제공됩니다. 이 콤보를 사용하면 웹 앱의 스크린샷으로 자동 생성된 끌어오기 요청을 사용할 수 있어 시각적 검증이 중요한 UI 중심 프로젝트에 적합합니다.
- 도구 과부하 수정: VS Code는 의미 체계 도구 조회를 출시하므로 에이전트가 90개 이상의 도구로 컨텍스트를 넘치지 않습니다. 대신 프롬프트에 따라 관련 항목만 표시됩니다. 이를 통해 GitHub와 같은 대규모 MCP 서버 작업을 훨씬 더 관리하기 쉽게 만듭니다.
다음은 무엇입니까?
GitHub MCP 레지스트리가 이제 막 시작되었습니다. 자체 출판부터 기업 채택까지 앞으로 일어날 일을 살펴보고 생태계가 어디로 향하고 있는지 확인할 수 있습니다.
- 자가 출판: 앞으로 몇 달 안에 예상됩니다. 이를 통해 커뮤니티 중심의 성장이 가능해지고 레지스트리가 모든 공용 MCP 서버의 정식 소스가 됩니다.
- 더 많은 IDE 지원: 다른 IDE도 출시될 예정입니다. 목표는 코드 작성 위치에 관계없이 MCP 서버 설치를 원활하게 만드는 것입니다.
- 엔터프라이즈 기능: 규제 대상 산업에서 MCP 사용을 활성화하는 데 도움이 되는 거버넌스 흐름입니다. 규정 준수를 협상할 수 없는 금융 서비스, 의료 및 기타 부문을 생각해 보십시오.
- 에이전트 워크플로우: GitHub MCP 서버는 원시 API 엔드포인트를 노출하는 대신 도구를 사용 사례 기반 흐름(예: “저장소 분석 + 풀 요청 열기”)에 번들링하기 시작합니다. 이렇게 하면 복잡한 작업 흐름이 간단한 명령처럼 느껴질 것입니다.
지금 시작하세요
GitHub MCP 레지스트리에는 현재 44개의 서버가 있으며 계속해서 성장할 것입니다(저희를 믿으세요!).
👉 GitHub에서 MCP 레지스트리 탐색
👉 지금 서버를 지정하려면 이메일을 보내주세요 [email protected].
곧 이 레지스트리는 MCP 서버의 단일 정보 소스가 되어 오래된 레지스트리를 거치지 않고도 도구를 검색, 설치 및 관리할 수 있는 한 곳을 제공하게 될 것입니다.
AI 지원 개발의 미래는 더 빠른 코딩에 관한 것이 아닙니다. 영향력을 증폭시키는 도구를 조정하는 것입니다. GitHub MCP 레지스트리는 오케스트레이션이 시작되는 곳입니다.
작성자:
Post Comment