MCP 서버 스타터

MCP 서버를 직접 만들고 싶으신가요?

MCP Server Starter는 MCP 표준을 사용하여 Cursor, Claude 등을 사용하여 로컬 도구를 실행할 수 있는 기본 구조를 제공합니다.

특징

📡 유연한 커뮤니케이션
- 클라이언트와 서버 간의 다양한 통신 프로토콜을 지원합니다.
- stdio : 로컬 사용법
- Streamable HTTP : 원격 및 로컬 사용
- sse : 원격 및 로컬 사용(더 이상 사용되지 않음)~~
📦 최소한의 설정 - 기본 서버 구현으로 빠르게 시작하세요.
🤖 커서 AI 통합 - .cursor/mcp.json 구성 예시가 포함되어 있습니다.
⌨️ TypeScript - 프로젝트에 유형 안전성을 추가하세요.

할 일

[ ] 자신의 패키지를 게시하는 옵션 추가
[ ] 스캐폴딩에 대한 더 나은 CLI 지원
[ ] 즉석에서 도구를 빌드하라는 메시지

시작하기

필수 조건

Node.js (필요한 경우 버전 지정)
MCP 호환 클라이언트(예: Cursor )

용법

지원되는 전송 옵션

모델 컨텍스트 프로토콜은 다양한 전송 방법을 지원합니다.

stdio

로컬 설정에 권장

코드 편집기 지원

아래 코드 조각을 추가하세요

커서: .cursor/mcp.json

로컬 개발/테스트

로컬에서 mcp 서버를 테스트하려면 이것을 사용하세요.

지엑스피1

게시된 패키지

npm 레지스트리에 패키지를 게시한 경우 이것을 사용하세요.

{
  "mcpServers": {
    "my-starter-mcp-stdio": {
      "command": "npx",
      "args": ["my-mcp-server", "--stdio"]
    }
  }
}

스트리밍 가능한 HTTP

중요: 스트리밍 가능한 HTTP는 아직 Cursor에서 지원되지 않습니다.

원격 서버 사용을 권장합니다

중요: stdio와 달리 올바른 플래그로 서버를 실행해야 합니다.

로컬 개발 streamable http 전송을 사용하세요

MCP 서버 시작 터미널에서 이것을 실행하세요

node ./bin/cli.mjs --http --port 4200

또는 mcp 검사관과 함께

npm run dev-http
# npm run dev-sse (deprecated)

이것을 구성에 추가하세요

{
  "mcpServers": {
    "my-starter-mcp-http": {
      "command": "node",
      "args": ["./bin/cli.mjs", "--http", "--port", "4001"]
      // "args": ["./bin/cli.mjs", "--sse", "--port", "4002"] (or deprecated sse usage)
    }
  }
}

게시된 패키지

npm 레지스트리에 패키지를 게시한 경우 이것을 사용하세요.

터미널에서 이것을 실행하세요

npx my-mcp-server --http --port 4200
# npx my-mcp-server --sse --port 4201 (deprecated)

{
  "mcpServers": {
    "my-starter-mcp-http": {
      "url": "http://localhost:4200/mcp"
      // "url": "http://localhost:4201/sse"
    }
  }
}

검사기를 사용하세요

inspect 명령을 사용하여 mcp 서버를 디버깅하세요.

명령줄 옵션

프로토콜 선택

규약	설명	깃발	노트
`stdio`	표준 I/O	(없음)	기본
`http`	HTTP REST	`--port <num>` (정의: 3000), `--endpoint <path>` (정의: `/mcp` )
`sse`	서버에서 보낸 이벤트	`--port <num>` (정의: 3000)	더 이상 사용되지 않음

특허

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.

모래밭

X/트위터: @kregenrek
블루스카이: @kevinkern.dev

행동

커서 AI 배우기: 궁극의 커서 코스
AI를 활용한 소프트웨어 구축 방법 배우기: instructa.ai

다른 프로젝트도 확인해 보세요:

AI 프롬프트 - Cursor AI, Cline, Windsurf 및 Github Copilot을 위한 큐레이션된 AI 프롬프트
codefetch - 간단한 터미널 명령 하나로 코드를 LLM용 Markdown으로 변환
AI 언어 모델에 대한 자세한 정보를 제공하는 CLI 도구 로 , 개발자가 자신의 필요에 맞는 올바른 모델을 선택하는 데 도움이 됩니다.# mcp-starter

MCP Starter

Integrations