{"_id":"@baehongjun0212/hello-world-mcp-server","name":"@baehongjun0212/hello-world-mcp-server","dist-tags":{"latest":"0.1.0"},"versions":{"0.1.0":{"name":"@baehongjun0212/hello-world-mcp-server","version":"0.1.0","description":"A simple Hello World MCP server that can be run with npx","main":"lib/index.js","bin":{"hello-world-mcp-server":"bin/hello-world-mcp-server.js"},"scripts":{"test":"echo \"Error: no test specified\" && exit 1"},"keywords":["mcp","model-context-protocol","ai","llm","hello-world"],"author":{"name":"Your Name"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/your-username/hello-world-mcp-server.git"},"engines":{"node":">=14.0.0"},"dependencies":{"which":"^3.0.0"},"bugs":{"url":"https://github.com/your-username/hello-world-mcp-server/issues"},"homepage":"https://github.com/your-username/hello-world-mcp-server#readme","_id":"@baehongjun0212/hello-world-mcp-server@0.1.0","_nodeVersion":"18.17.0","_npmVersion":"9.6.7","dist":{"integrity":"sha512-eTbDjEFB/qC7xAPrS/3bqABem22mRFn0qyWmwm+eVSlSZND08WGi/Cszloi6yfWfW/8oJaPvB7Z236EIvvJi7A==","shasum":"d9aaa302558128bc146bbe294244d6e1f100bdea","tarball":"https://registry.npmjs.org/@baehongjun0212/hello-world-mcp-server/-/hello-world-mcp-server-0.1.0.tgz","fileCount":12,"unpackedSize":18727,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIFBRS+HXZmx6tL0SeOnBXtoylHRvij6nX0tBrzpCFayWAiB4Wv5YrAXfR23KzL0A0mjGiHAZRlKIV6MDGQxJTN1hqA=="}]},"_npmUser":{"name":"baehongjun0212","email":"sembuat12@naver.com","actor":{"name":"baehongjun0212","email":"sembuat12@naver.com","type":"user"}},"directories":{},"maintainers":[{"name":"baehongjun0212","email":"sembuat12@naver.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/hello-world-mcp-server_0.1.0_1750256347560_0.02820904168032934"},"_hasShrinkwrap":false}},"time":{"created":"2025-06-18T14:19:07.441Z","0.1.0":"2025-06-18T14:19:07.738Z","modified":"2025-06-18T14:19:08.035Z"},"maintainers":[{"name":"baehongjun0212","email":"sembuat12@naver.com"}],"description":"A simple Hello World MCP server that can be run with npx","homepage":"https://github.com/your-username/hello-world-mcp-server#readme","keywords":["mcp","model-context-protocol","ai","llm","hello-world"],"repository":{"type":"git","url":"git+https://github.com/your-username/hello-world-mcp-server.git"},"author":{"name":"Your Name"},"bugs":{"url":"https://github.com/your-username/hello-world-mcp-server/issues"},"license":"MIT","readme":"# Hello World MCP Server\n\n간단한 Hello World 기능을 제공하는 MCP (Model Context Protocol) 서버입니다.\n\n## 기능\n\n이 MCP 서버는 다음과 같은 도구들을 제공합니다:\n\n1. **hello_world** - 이름을 받아서 인사말을 반환합니다\n\n   - 매개변수: `name` (선택사항, 기본값: \"World\")\n   - 예시: `hello_world(name=\"Alice\")` → \"Hello, Alice! 👋\"\n\n2. **get_greeting** - 다양한 언어로 인사말을 반환합니다\n   - 매개변수: `language` (필수)\n   - 지원 언어: english, korean, spanish, french, japanese\n   - 예시: `get_greeting(language=\"korean\")` → \"안녕하세요! 오늘 어떻게 지내세요?\"\n\n## 빠른 시작 (권장)\n\n### 사전 요구사항\n\n- UV (Python 패키지 관리 도구)\n\n  ```bash\n  # macOS\n  brew install uv\n\n  # 기타 OS\n  # https://docs.astral.sh/uv/getting-started/installation/\n  ```\n\n### npx로 바로 사용하기\n\nAI 도구(Cursor, Claude Desktop 등)의 MCP 설정에 다음 내용을 추가합니다:\n\n```json\n{\n  \"mcpServers\": {\n    \"hello-world\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@baehongjun0212/hello-world-mcp-server@latest\"]\n    }\n  }\n}\n```\n\n설정 후 AI 도구를 재시작하면 바로 사용할 수 있습니다!\n\n## 개발자를 위한 설치 방법\n\n### 1. 소스에서 설치\n\n```bash\n# 저장소 클론\ngit clone <repository-url>\ncd hello-world-mcp-server\n\n# Python 의존성 설치\nuv sync\n\n# (선택사항) Node.js 의존성 설치 (npm 배포를 위해)\nnpm install\n```\n\n### 2. 개발 환경에서 실행\n\n```bash\n# Python으로 직접 실행\nuv run hello-world-mcp-server\n\n# 또는 Node.js wrapper로 실행\nnode bin/hello-world-mcp-server.js\n```\n\n### 3. AI 도구에 로컬 개발 버전 등록\n\n```json\n{\n  \"mcpServers\": {\n    \"hello-world-dev\": {\n      \"command\": \"uv\",\n      \"args\": [\n        \"--directory\",\n        \"/path/to/hello-world-mcp-server\",\n        \"run\",\n        \"hello-world-mcp-server\"\n      ]\n    }\n  }\n}\n```\n\n## npm 패키지 배포 (관리자용)\n\n### 1. npm 로그인\n\n```bash\nnpm login\n```\n\n### 2. 패키지 이름 변경\n\n`package.json`에서 `@your-username`을 실제 npm 사용자명으로 변경:\n\n```json\n{\n  \"name\": \"@your-username/hello-world-mcp-server\",\n  ...\n}\n```\n\n### 3. 배포\n\n```bash\nnpm publish --access public\n```\n\n## 프로젝트 구조\n\n```\nhello-world-mcp-server/\n├── bin/\n│   └── hello-world-mcp-server.js  # Node.js 실행 파일\n├── lib/\n│   └── index.js                   # Node.js API\n├── src/\n│   └── hello_world_mcp_server/\n│       ├── __init__.py\n│       ├── __main__.py           # Python 진입점\n│       └── server.py             # MCP 서버 구현\n├── package.json                  # npm 패키지 설정\n├── pyproject.toml               # Python 프로젝트 설정\n├── README.md                    # 이 문서\n├── .gitignore\n├── .npmignore                   # npm 배포 제외 파일\n└── .python-version\n```\n\n## 개발\n\n### 테스트 실행\n\n```bash\nuv run pytest\n```\n\n### 코드 린팅\n\n```bash\nuv run ruff check .\nuv run ruff format .\n```\n\n## 문제 해결\n\n### \"uv is not installed\" 오류\n\nUV가 설치되지 않았습니다. 다음 명령으로 설치하세요:\n\n```bash\nbrew install uv  # macOS\n```\n\n### Python 버전 오류\n\nPython 3.12 이상이 필요합니다. UV는 자동으로 올바른 Python 버전을 관리합니다.\n\n## 라이선스\n\nMIT License\n","readmeFilename":"README.md","_rev":"1-eda0e24950b896ecdd9f00ada4fe4be0"}