mcp-server

acorn025/mcp-server

3.1

If you are the rightful owner of mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.

This document provides a comprehensive guide to setting up and running a Model Context Protocol (MCP) server, including installation, development, and production execution.

Tools
2
Resources
0
Prompts
0

MCP 서버 개발 환경

Model Context Protocol (MCP) 서버 개발을 위한 기본 환경입니다.

시작하기

1. 의존성 설치

npm install

2. 개발 모드로 실행

npm run dev

3. 빌드

npm run build

4. 프로덕션 모드로 실행

npm start

프로젝트 구조

mcp-server/
├── src/
│   └── index.ts          # 메인 서버 코드
├── dist/                 # 빌드 출력 (자동 생성)
├── package.json          # 프로젝트 설정 및 의존성
├── tsconfig.json         # TypeScript 설정
└── README.md            # 이 파일

기능

현재 구현된 기능:

도구 (Tools)

  • echo: 입력된 텍스트를 그대로 반환
  • add: 두 숫자를 더함
  • generate_nickname: 키워드 3-4개와 스타일을 조합하여 자연스러운 영어 닉네임을 생성
    • 키워드: 한글/영어 키워드 입력 가능 (한글은 자동으로 영어로 변환)
    • 스타일: "aesthetic", "cute", "game", "professional"
    • 반환: 7~12자 길이의 영어 닉네임

리소스 (Resources)

  • example://resource1: 예제 텍스트 리소스
  • example://resource2: 예제 JSON 리소스

프로젝트 구조

mcp-server/
├── src/
│   └── index.ts          # 메인 서버 코드
├── mcp/
│   └── modules/
│       └── nickname.py   # 닉네임 생성 모듈
├── dist/                 # 빌드 출력 (자동 생성)
├── package.json          # 프로젝트 설정 및 의존성
├── requirements.txt      # Python 의존성 (표준 라이브러리만 사용)
├── tsconfig.json         # TypeScript 설정
└── README.md            # 이 파일

개발 가이드

새로운 도구 추가하기

  1. ListToolsRequestSchema 핸들러에 도구 정의 추가
  2. CallToolRequestSchema 핸들러에 도구 실행 로직 추가

새로운 리소스 추가하기

  1. ListResourcesRequestSchema 핸들러에 리소스 정의 추가
  2. ReadResourceRequestSchema 핸들러에 리소스 읽기 로직 추가

참고 자료