예시 (Examples)

사용 가능한 도구 (Available Tools)

searchAppleDocumentation

Apple Developer 문서를 검색합니다

매개변수(Parameters): query

(string) 제목, URL, 설명, 브레드크럼(breadcrumbs), 태그가 포함된 구조화된 결과를 반환합니다

fetchAppleDocumentation

경로(path)를 통해 Apple Developer 문서 및 Human Interface Guidelines를 가져옵니다

매개변수(Parameters): path

(string) - 문서 경로 (예: '/documentation/swift', 'design/human-interface-guidelines/foundations/color') 콘텐츠를 Markdown 형식으로 반환합니다

fetchAppleVideoTranscript

비디오 경로를 통해 WWDC 세션을 포함한 비디오 스크립트(transcripts)를 가져옵니다

매개변수(Parameters): path

(string) - 비디오 경로 (예: '/videos/play/wwdc2021/10133', '/videos/play/meet-with-apple/208') 콘텐츠를 Markdown 형식으로 반환합니다

fetchExternalDocumentation

절대 HTTPS URL을 통해 외부 Swift-DocC 문서를 가져옵니다

매개변수(Parameters): url

(string) - 외부 URL (예: 'https://apple.github.io/swift-argument-parser/documentation/argumentparser') 콘텐츠를 Markdown 형식으로 반환합니다

문제 해결 (Troubleshooting)

MCP 서버와 관련하여 연결 시간 초과(connection timeouts) 또는 네트워크 문제를 겪고 있다면, 프록시(proxy)를 설정해야 할 수도 있습니다. 이는 특히 기업 환경이나 인터넷 접속이 제한된 지역에서 흔히 발생합니다.

환경 변수를 추가하여 MCP 클라이언트가 프록시를 사용하도록 설정하십시오:

{
"mcpServers": {
"sosumi": {
...

proxy.example.com:8080을 실제 프록시 서버 상세 정보로 교체하십시오.
인증이 필요한 프록시의 경우 다음 형식을 사용하십시오:
http://username:password@proxy.example.com:8080

npx (Node.js에 포함됨)로 직접 실행:

npx @nshipster/sosumi fetch https://developer.apple.com/documentation/swift/array

정기적으로 사용하는 경우, 한 번 설치하십시오:

npm i -g @nshipster/sosumi

bunx (Bun에 포함됨)로 직접 실행:

bunx @nshipster/sosumi fetch https://developer.apple.com/documentation/swift/array

정기적으로 사용하는 경우, 한 번 설치하십시오:

bun i -g @nshipster/sosumi

deno run으로 직접 실행:

deno run -A npm:@nshipster/sosumi fetch https://developer.apple.com/documentation/swift/array

정기적으로 사용하는 경우, 한 번 설치하십시오:

deno install -g -A npm:@nshipster/sosumi

문서 가져오기 (Fetching Documentation)

MCP 도구가 지원하는 모든 콘텐츠 유형을 가져올 수 있습니다 — API 문서 (API docs), 휴먼 인터페이스 가이드라인 (Human Interface Guidelines), WWDC 세션, 그리고 외부 Swift-DocC 페이지:

sosumi fetch /documentation/swift/array
sosumi fetch /design/human-interface-guidelines/color
sosumi fetch /videos/play/wwdc2021/10133
...

검색 (Searching)

Apple Developer 문서를 검색합니다:

sosumi search "SwiftData"

JSON 출력 (JSON Output)

기본적으로 출력은 일반 텍스트 (plain text) 또는 마크다운 (Markdown)입니다.
스크립트용으로 사용하려면 --json을 추가하십시오:

sosumi fetch /documentation/swift/array --json
sosumi search "SwiftData" --json

로컬 서버 (Local Server)

배포된 패키지로부터 서버의 로컬 인스턴스를 실행합니다:

sosumi serve
sosumi serve --port 8787

재사용 가능한 스킬 (skill)로 설치 (개인 또는 프로젝트 수준):

# 개인 스킬 (모든 프로젝트)
mkdir -p ~/.claude/skills/sosumi
curl -o ~/.claude/skills/sosumi/SKILL.md https://sosumi.ai/SKILL.md
...

전역(Global) 설치:

# 전역 지침 (모든 프로젝트)
mkdir -p ~/.agents/skills/sosumi
curl -o ~/.agents/skills/sosumi/SKILL.md https://sosumi.ai/SKILL.md

Cursor 스킬로 설치 (전역 또는 프로젝트 수준):

# 개인 스킬 (모든 프로젝트)
mkdir -p ~/.cursor/skills/sosumi
curl -o ~/.cursor/skills/sosumi/SKILL.md https://sosumi.ai/SKILL.md
...

AGENTS 호환 도구의 경우, 재사용 가능한 스킬로 설치하십시오:

mkdir -p ~/.agents/skills/sosumi
curl -o ~/.agents/skills/sosumi/SKILL.md https://sosumi.ai/SKILL.md