Communitygithub.com

aiskillstore/marketplace

LLM(대규모 언어 모델)이 외부 서비스와 상호 작용할 수 있도록 잘 설계된 도구를 통해 MCP(Model Context Protocol) 서버를 구축하기 위한 가이드입니다. 외부 API나 서비스를 통합하는 MCP 서버를 구축할 때( Python(FastMCP) 또는 Node/TypeScript(MCP SDK) ) 이 스킬을 사용하세요.

marketplace란 무엇인가요?

이 스킬은 AI 에이전트(예: Claude Code, Cursor, Codex)가 고품질 MCP(Model Context Protocol) 서버를 개발할 수 있도록 상세한 단계별 가이드를 제공합니다. MCP 서버는 LLM이 잘 설계된 도구를 통해 외부 서비스와 상호 작용할 수 있게 해주는 핵심 구성 요소입니다. 이 가이드는 심층 연구 및 계획, 구현, 검토 및 테스트, 평가 생성의 4단계 프로세스를 따릅니다. TypeScript(MCP SDK 권장)와 Python(FastMCP)을 모두 지원하며, API 커버리지 최적화, 도구 명명 규칙, 컨텍스트 관리, 그리고 효과적인 오류 메시지 설계 방법을 다룹니다. 또한, 에이전트가 최종 품질을 보장하기 위해 포괄적인 평가(10개의 복잡한 질문)를 생성하는 방법도 안내합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/aiskillstore/marketplace/tree/HEAD/skills/mcp-builder

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

MCP 서버 개발 가이드

개요

잘 설계된 도구를 통해 LLM이 외부 서비스와 상호 작용할 수 있도록 해주는 MCP(Model Context Protocol) 서버를 생성합니다. MCP 서버의 품질은 LLM이 실제 작업을 얼마나 잘 수행할 수 있게 하는지에 따라 측정됩니다.


프로세스

🚀 상위 수준 워크플로우

고품질 MCP 서버를 만드는 과정은 네 가지 주요 단계로 구성됩니다.

1단계: 심층 연구 및 계획

1.1 최신 MCP 설계 이해

API 커버리지 vs. 워크플로 도구: 포괄적인 API 엔드포인트 커버리지와 특화된 워크플로 도구 간의 균형을 유지하세요. 워크플로 도구는 특정 작업에 더 편리할 수 있는 반면, 포괄적인 커버리지는 에이전트에게 작업을 유연하게 구성할 수 있는 자유를 제공합니다. 성능은 클라이언트에 따라 다릅니다. 일부 클라이언트는 기본 도구를 결합하는 코드 실행의 이점을 얻는 반면, 다른 클라이언트는 더 높은 수준의 워크플로에서 더 잘 작동합니다. 확실하지 않은 경우, 포괄적인 API 커버리지를 우선시하세요.

도구 명명 및 검색 가능성: 명확하고 설명적인 도구 이름은 에이전트가 필요한 도구를 빠르게 찾는 데 도움이 됩니다. 일관된 접두사(예: github_create_issue, github_list_repos)와 동작 중심의 명명 규칙을 사용하세요.

컨텍스트 관리: 에이전트는 간결한 도구 설명과 결과를 필터링/페이지네이션할 수 있는 기능의 이점을 얻습니다. 집중적이고 관련성 높은 데이터를 반환하는 도구를 설계하세요. 일부 클라이언트는 코드 실행을 지원하며, 이는 에이전트가 데이터를 효율적으로 필터링하고 처리하는 데 도움이 될 수 있습니다.

실행 가능한 오류 메시지: 오류 메시지는 특정 제안과 다음 단계를 통해 에이전트를 해결책으로 안내해야 합니다.

1.2 MCP 프로토콜 문서 학습

MCP 사양 탐색:

사이트맵에서 관련 페이지를 찾는 것으로 시작하세요: https://modelcontextprotocol.io/sitemap.xml

그런 다음 마크다운 형식을 위해 .md 접미사가 있는 특정 페이지를 가져오세요(예: https://modelcontextprotocol.io/specification/draft.md).

검토해야 할 주요 페이지:

  • 사양 개요 및 아키텍처
  • 전송 메커니즘(Streamable HTTP, stdio)
  • 도구, 리소스 및 프롬프트 정의

1.3 프레임워크 문서 학습

권장 스택:

  • 언어: TypeScript(고품질 SDK 지원 및 MCPB와 같은 많은 실행 환경에서 우수한 호환성 제공. 또한 AI 모델은 TypeScript 코드 생성에 능숙하며, 광범위한 사용, 정적 타이핑 및 우수한 린팅 도구의 이점을 누립니다.)
  • 전송: 원격 서버의 경우 Streamable HTTP(상태 저장 세션 및 스트리밍 응답과 달리 확장 및 유지 관리가 더 간단한 무상태 JSON 사용). 로컬 서버의 경우 stdio.

프레임워크 문서 로드:

TypeScript(권장)의 경우:

  • TypeScript SDK: WebFetch를 사용하여 https://raw.githubusercontent.com/modelcontextprotocol/typescript-sdk/main/README.md를 로드하세요.
  • ⚡ TypeScript 가이드 - TypeScript 패턴 및 예제

Python의 경우:

  • Python SDK: WebFetch를 사용하여 https://raw.githubusercontent.com/modelcontextprotocol/python-sdk/main/README.md를 로드하세요.
  • 🐍 Python 가이드 - Python 패턴 및 예제

1.4 구현 계획 수립

API 이해: 서비스의 API 문서를 검토하여 주요 엔드포인트, 인증 요구 사항 및 데이터 모델을 식별하세요. 필요에 따라 웹 검색 및 WebFetch를 사용하세요.

도구 선택: 포괄적인 API 커버리지를 우선시하세요. 가장 일반적인 작업부터 시작하여 구현할 엔드포인트를 나열하세요.


2단계: 구현

2.1 프로젝트 구조 설정

프로젝트 설정에 대한 언어별 가이드를 참조하세요:

2.2 핵심 인프라 구현

공유 유틸리티 생성:

  • 인증이 포함된 API 클라이언트
  • 오류 처리 헬퍼
  • 응답 형식 지정(JSON/마크다운)
  • 페이지네이션 지원

2.3 도구 구현

각 도구에 대해:

입력 스키마:

  • Zod(TypeScript) 또는 Pydantic(Python) 사용
  • 제약 조건과 명확한 설명 포함
  • 필드 설명에 예제 추가

출력 스키마:

  • 가능한 경우 구조화된 데이터를 위해 outputSchema 정의
  • 도구 응답에 structuredContent 사용(TypeScript SDK 기능)
  • 클라이언트가 도구 출력을 이해하고 처리하는 데 도움

도구 설명:

  • 기능에 대한 간결한 요약
  • 매개변수 설명
  • 반환 유형 스키마

구현:

  • I/O 작업에 Async/await 사용
  • 실행 가능한 메시지와 함께 적절한 오류 처리
  • 해당되는 경우 페이지네이션 지원
  • 최신 SDK 사용 시 텍스트 콘텐츠와 구조화된 데이터를 모두 반환

주석:

  • readOnlyHint: true/false
  • destructiveHint: true/false
  • idempotentHint: true/false
  • openWorldHint: true/false

3단계: 검토 및 테스트

3.1 코드 품질

다음 사항을 검토하세요:

  • 중복 코드 없음(DRY 원칙)
  • 일관된 오류 처리
  • 전체 유형 커버리지
  • 명확한 도구 설명

3.2 빌드 및 테스트

TypeScript:

  • npm run build를 실행하여 컴파일 확인
  • MCP 인스펙터로 테스트: npx @modelcontextprotocol/inspector

Python:

  • 구문 확인: python -m py_compile your_server.py
  • MCP 인스펙터로 테스트

자세한 테스트 접근 방식 및 품질 체크리스트는 언어별 가이드를 참조하세요.


4단계: 평가 생성

MCP 서버를 구현한 후, 효과성을 테스트하기 위한 포괄적인 평가를 생성하세요.

전체 평가 지침은 ✅ 평가 가이드를 로드하세요.

4.1 평가 목적 이해

평가를 사용하여 LLM이 MCP 서버를 효과적으로 사용하여 현실적이고 복잡한 질문에 답할 수 있는지 테스트하세요.

4.2 평가 질문 10개 생성

효과적인 평가를 생성하려면 평가 가이드에 설명된 프로세스를 따르세요:

  1. 도구 검사: 사용 가능한 도구를 나열하고 해당 기능 이해
  2. 콘텐츠 탐색: 읽기 전용 작업을 사용하여 사용 가능한 데이터 탐색
  3. 질문 생성: 10개의 복잡하고 현실적인 질문 생성
  4. 답변 확인: 각 질문을 직접 해결하여 답변 확인

4.3 평가 요구 사항

각 질문이 다음 조건을 충족하는지 확인하세요:

  • 독립적: 다른 질문에 의존하지 않음
  • 읽기 전용: 비파괴적 작업만 필요
  • 복잡함: 여러 도구 호출과 심층 탐색 필요
  • 현실적: 사람들이 관심을 가질 실제 사용 사례 기반
  • 검증 가능: 문자열 비교로 검증 가능한 단일하고 명확한 답변
  • 안정적: 시간이 지나도 답변이 변경되지 않음

4.4 출력 형식

이 구조로 XML 파일을 생성하세요:

<evaluation>
  <qa_pair>
    <question>동물 코드명을 가진 AI 모델 출시에 관한 토론을 찾으세요. 한 모델은 ASL-X 형식을 사용하는 특정 안전 지정이 필요했습니다. 점박이 야생 고양이의 이름을 딴 모델에 대해 어떤 숫자 X가 결정되었습니까?</question>
    <answer>3</answer>
  </qa_pair>
<!-- 추가 qa_pair... -->
</evaluation>

참조 파일

📚 문서 라이브러리

개발 중 필요에 따라 다음 리소스를 로드하세요:

핵심 MCP 문서(먼저 로드)

  • MCP 프로토콜: https://modelcontextprotocol.io/sitemap.xml의 사이트맵에서 시작하여 .md 접미사가 있는 특정 페이지를 가져오세요.
  • 📋 MCP 모범 사례 - 보편적인 MCP 지침 포함:
    • 서버 및 도구 명명 규칙
    • 응답 형식 지침(JSON vs 마크다운)
    • 페이지네이션 모범 사례
    • 전송 선택(Streamable HTTP vs stdio)
    • 보안 및 오류 처리 표준

SDK 문서(1/2단계에서 로드)

  • Python SDK: https://raw.githubusercontent.com/modelcontextprotocol/python-sdk/main/README.md에서 가져오기
  • TypeScript SDK: https://raw.githubusercontent.com/modelcontextprotocol/typescript-sdk/main/README.md에서 가져오기

언어별 구현 가이드(2단계에서 로드)

  • 🐍 Python 구현 가이드 - 다음을 포함한 완전한 Python/FastMCP 가이드:

    • 서버 초기화 패턴
    • Pydantic 모델 예제
    • @mcp.tool을 사용한 도구 등록
    • 완전한 작동 예제
    • 품질 체크리스트
  • ⚡ TypeScript 구현 가이드 - 다음을 포함한 완전한 TypeScript 가이드:

    • 프로젝트 구조
    • Zod 스키마 패턴
    • server.registerTool을 사용한 도구 등록
    • 완전한 작동 예제
    • 품질 체크리스트

평가 가이드(4단계에서 로드)

  • ✅ 평가 가이드 - 다음을 포함한 완전한 평가 생성 가이드:
    • 질문 생성 지침
    • 답변 확인 전략
    • XML 형식 사양
    • 예제 질문 및 답변
    • 제공된 스크립트로 평가 실행

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

aiskillstore/marketplace

Create high-converting, visually distinctive landing pages. Use when building marketing pages, product launches, SaaS homepages, or any single-page conversion-focused website. Guides section-by-section composition with anti-AI-slop principles.

aiskillstore/marketplace

Auto-loaded context for Portfolio Buddy 2 development. Use for ANY task involving: React 19 development, TypeScript, portfolio analysis features, metrics calculations, trading strategy comparison, or working with the Portfolio Buddy 2 codebase. Contains tech stack, known issues, and architectural constraints.

aiskillstore/marketplace

Use when the user asks to "pre-launch check the landing page", "run a Quality-Score preflight", or "verify ad-to-page message match before launch"; produces an ad↔page continuity report — message-match gaps, above-the-fold check, page-speed read, form-friction count, mobile-render flags — as a pass/fix punch list. Not for redesigning or rewriting the page — use landing-optimizer; not for scoring the account or the RQS — use ad-account-auditor. 落地页体验预检/广告落地页一致性检查

aiskillstore/marketplace

Use when the user asks to "optimize our landing page for influencer traffic", "fix our promo-code landing page", or "improve conversion from a creator campaign"; produces a message-match audit, page-structure and social-proof recommendations, a promo-code/CTA conversion plan, and an A/B test roadmap. Not for measuring campaign results after launch — use performance-analyzer.

aiskillstore/marketplace

Audit a landing page, sales page or checkout page for conversion leaks and return a fix list ordered by expected revenue impact. Use when asked to review, critique or improve a landing page, sales page, opt-in page, product page or checkout flow, when conversion rate is low, when paid traffic is not converting, or when someone asks "why isn't this page converting" or wants a CRO / landing page review.

aiskillstore/marketplace

This skill helps users extract GitHub repository project details and contributor contact information using keywords, stars, and update dates. Agent should proactively apply this skill when users express needs like search for GitHub projects by keywords, find top open-source contributors in specific domains, extract developer contacts from GitHub repositories, discover trending repositories with high stars, gather contributor profiles and social links for tech recruiting, retrieve GitHub project descriptions and metrics, build developer communities by finding active contributors, search for repositories updated recently, collect personal website and Twitter links of developers, generate targeted leads for developer tools, or track active open-source contributors for collaboration.

aiskillstore/marketplace

Create beautiful visual art in .png and .pdf documents using design philosophy. You should use this skill when the user asks to create a poster, piece of art, design, or other static piece. Create original visual designs, never copying existing artists' work to avoid copyright violations.

aiskillstore/marketplace

Using the Wonda CLI to generate images, videos, music, and audio from the terminal — plus LinkedIn, Reddit, and X/Twitter research and automation

aiskillstore/marketplace

Comprehensive document creation, editing, and analysis with support for tracked changes, comments, formatting preservation, and text extraction. When Claude needs to work with professional documents (.docx files) for: (1) Creating new documents, (2) Modifying or editing content, (3) Working with tracked changes, (4) Adding comments, or any other document tasks

aiskillstore/marketplace

Generates creative domain name ideas for your project and checks availability across multiple TLDs (.com, .io, .dev, .ai, etc.). Saves hours of brainstorming and manual checking.

aiskillstore/marketplace

Process video files with audio extraction, format conversion (mp4, webm), and Whisper transcription. Use when user mentions video conversion, audio extraction, transcription, mp4, webm, ffmpeg, or whisper transcription.

aiskillstore/marketplace

Generate or edit raster images when the task benefits from AI-created bitmap visuals such as photos, illustrations, textures, sprites, mockups, or transparent-background cutouts. Use when Codex should create a brand-new image, transform an existing image, or derive visual variants from references, and the output should be a bitmap asset rather than repo-native code or vector. Do not use when the task is better handled by editing existing SVG/vector/code-native assets, extending an established icon or logo system, or building the visual directly in HTML/CSS/canvas.

aiskillstore/marketplace

A set of resources to help me write all kinds of internal communications, using the formats that my company likes to use. Claude should use this skill whenever asked to write some sort of internal communications (status reports, leadership updates, 3P updates, company newsletters, FAQs, incident reports, project updates, etc.).

aiskillstore/marketplace

Router skill for LLMQuant portfolio workflows. Use when the user needs company profiles, thesis tracking, theme research, watchlist monitoring, or alert management.

aiskillstore/marketplace

Account assets, equity and fund positions, P&L, cash flow records, account statements, margin ratios, buy-power estimates, order management, and DCA recurring investments via Longbridge (most require Trade permission). Frameworks: portfolio diagnosis, rebalancing, asset allocation, risk analysis (VaR/CVaR), performance attribution, and tax-loss harvesting. Triggers: "持仓", "账户", "盈亏", "资产", "对账单", "下单", "买入", "卖出", "撤单", "定投", "组合诊断", "再平衡", "资产配置", "风险分析", "绩效归因", "税损收割", "持倉", "賬戶", "盈虧", "對賬單", "下單", "買入", "賣出", "組合診斷", "再平衡", "稅損收割", "positions", "portfolio", "P&L", "order", "buy", "sell", "DCA", "statement", "risk analysis", "rebalancing", "tax harvesting", "我的风险", "持仓风险", "风险敞口", "資產", "資產配置", "風險分析", "績效歸因", "撤單

aiskillstore/marketplace

Use for Codex models/pricing, scheduled tasks, skills, settings, setup, troubleshooting, customization, automations, and self-knowledge—including 'you,' 'your,' 'this app,' or 'this coding agent' when they refer to Codex—and for OpenAI APIs/products and ChatGPT Work. Also use for model choice/migration, prompting, SDKs, Responses, Realtime, agents, evals, and Chat/Work/Codex comparisons. Do not use for generic app/software tasks that merely mention Codex.

aiskillstore/marketplace

Comprehensive PDF manipulation toolkit for extracting text and tables, creating new PDFs, merging/splitting documents, and handling forms. When Claude needs to fill in a PDF form or programmatically process, generate, or analyze PDF documents at scale.

aiskillstore/marketplace

Presentation creation, editing, and analysis. When Claude needs to work with presentations (.pptx files) for: (1) Creating new presentations, (2) Modifying or editing content, (3) Working with layouts, (4) Adding comments or speaker notes, or any other presentation tasks

aiskillstore/marketplace

Perform a read-only, defect-first review of a specified code change and return every actionable finding. Use when another agent delegates review of uncommitted changes, a base-branch diff, a commit, or custom review instructions.

aiskillstore/marketplace

Expert in building portfolios that actually land jobs and clients - not just showing work, but creating memorable experiences. Covers developer portfolios, designer portfolios, creative portfolios, and portfolios that convert visitors into opportunities.

관련 스킬