my-mcp-server

TypeScript로 MCP (Model Context Protocol) 서버를 구축하기 위한 플레이그라운드 및 실험 프로젝트입니다. stdio 전송을 통해 AI 에이전트와 언어 모델에 도구와 리소스를 노출하는 방법을 보여줍니다.

이 서버는 간단한 사용자 데이터베이스(로컬 JSON 파일 기반)를 관리하며, AI 에이전트가 호출하여 사용자 레코드를 읽거나 생성할 수 있는 엔드포인트를 노출합니다.

기능

• 도구 — my-create-tool: name, address, email, phone 필드를 받아 새 사용자를 생성하고 레코드를 src/users.json에 저장합니다.

• 리소스 — users://all: 목업 데이터베이스의 전체 사용자 목록을 JSON으로 반환합니다.

• 리소스 — users://{userId}/profile: userId로 식별되는 단일 사용자의 프로필을 반환합니다.

Related MCP server: FastMCP Example Server

사전 요구 사항

• Node.js v18 이상

• npm v9 이상

설치

npm install

서버 실행

개발 모드 (tsx 사용, 빌드 단계 없음)

npm run server:dev

빌드 및 컴파일된 출력 실행

npm run server:build   # compiles TypeScript → JavaScript
node dist/server.js    # run the compiled server

감시 모드 (변경 시 자동 재컴파일)

npm run server:build:watch

MCP Inspector UI로 검사

MCP Inspector를 사용하면 브라우저 UI에서 도구를 대화형으로 호출하고 리소스를 탐색할 수 있습니다:

npm run server:inspect

참고: server:inspect는 DANGEROUSLY_OMIT_AUTH=true를 설정합니다 — 로컬 개발에서만 사용하세요.

에이전트 환경에서 MCP 서버 로드

에이전트 CLI (예: Claude Code CLI)

.mcp.json 파일이 존재하면 에이전트가 이를 자동으로 감지하고 서버 로드를 요청합니다. 그렇지 않은 경우, 다른 서버와 함께 구성에 추가해야 하는 간단한 MCP 서버 구성입니다.

프로젝트 구조

my-mcp-server/
├── src/
│   ├── server.ts      # MCP server entry point (tools & resources)
│   └── users.json     # Mock user database (read/written at runtime)
├── package.json
└── tsconfig.json

기술 스택

라이선스

ISC