Capability Manifest

~18 min · manifest, capabilities, metadata, versioning

Level 0호기심 많은 독자

0 XP0/48 lessons0/14 achievements

0/100 XP to next level100 XP to go0% complete

Runtime handshake 너머, 실제 MCP server 는 작은 manifest ship — 보통 pyproject.toml 또는 package.json — server 이름, 버전, entry point, support commit 한 protocol revision 명명. Manifest 가 — registry, package manager, Claude Desktop 'add server' UI 가 — 읽는 거.

Metadata 에 protocol revision 명시적 pin. Changelog 짧고 정직: "v1.4.0: refund_order tool 추가, protocol-version 2025-03-26 support drop." 미래의 너와 업그레이드하는 다음 user 둘 다 그 line 에 의존. Versioning track 매트릭스 mirror 하는 compatibility section 추가.

Python server 는 uv / uvx 통해 entry point 노출: [project.scripts] my-server = "my_server:main". 이제 어느 host 든 — user 가 virtualenv 걱정 없이 — 한 명령 (uvx my-server) 으로 server 띄움. TypeScript/Node server 는 npx 가 등가.

Code

pyproject.toml — 진짜 manifest 모양·toml

[project]
name = "my-mcp-server"
version = "1.4.0"
description = "MCP server for orders + refunds"
authors = [{ name = "You", email = "you@example.com" }]
requires-python = ">=3.11"
dependencies = ["mcp>=0.6.0", "httpx>=0.27"]

[project.scripts]
my-mcp-server = "my_mcp_server:main"

[tool.mcp]
# 비-표준 컨벤션이지만 점점 흔해짐
protocol_versions_supported = ["2025-11-25", "2025-06-18"]
clients_tested = ["claude-desktop", "cursor", "vscode-copilot"]

uvx 통한 발견 가능 entry point·bash

# 누구나 — 글로벌 install 없이 — server 돌릴 수 있음
uvx my-mcp-server

# 또는 release pin
uvx my-mcp-server==1.4.0

External links

Exercise

짠 server 에 진짜 pyproject.toml 작성 — script entry point, 명시적 protocol-version pin, 테스트된 client note 와 함께. Publish (또는 그냥 uv build) 후 로컬에서 uvx 시도. Install 길의 깔끔함 자체가 연습.

Progress

Progress is local-only — sign in to sync across devices.

← Previous최소 MCP Server (Python SDK)Next →Claude Desktop 연결

이 페이지에서 버그를 발견하셨거나 피드백이 있으세요?문제 신고

🔔 답글 알림 (로그인 필요)

로그인 — 댓글을 남기려면 로그인해 주세요.

아직 댓글이 없어요. 첫 댓글을 남겨보세요.