{"id":30272081,"url":"https://github.com/slicequeue/poc-node-mcp-server","last_synced_at":"2026-01-20T16:43:33.515Z","repository":{"id":305363923,"uuid":"1022692800","full_name":"slicequeue/poc-node-mcp-server","owner":"slicequeue","description":null,"archived":false,"fork":false,"pushed_at":"2025-07-19T16:21:06.000Z","size":29,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-07-19T20:06:45.858Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/slicequeue.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-07-19T16:11:12.000Z","updated_at":"2025-07-19T16:21:09.000Z","dependencies_parsed_at":"2025-07-19T20:06:48.363Z","dependency_job_id":"44b973b0-7ebf-4e57-a33c-8eecfbc86783","html_url":"https://github.com/slicequeue/poc-node-mcp-server","commit_stats":null,"previous_names":["slicequeue/poc-node-mcp-server"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/slicequeue/poc-node-mcp-server","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/slicequeue%2Fpoc-node-mcp-server","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/slicequeue%2Fpoc-node-mcp-server/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/slicequeue%2Fpoc-node-mcp-server/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/slicequeue%2Fpoc-node-mcp-server/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/slicequeue","download_url":"https://codeload.github.com/slicequeue/poc-node-mcp-server/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/slicequeue%2Fpoc-node-mcp-server/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":270670063,"owners_count":24625444,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-16T02:00:11.002Z","response_time":91,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-08-16T05:13:14.127Z","updated_at":"2025-09-23T17:06:57.231Z","avatar_url":"https://github.com/slicequeue.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# POC Node MCP Server\n\n**POC (Proof of Concept)** - MCP(Model Context Protocol) 서버 개발 학습 및 테스트를 위한 데모 프로젝트입니다.\n\n다양한 계산 도구와 사용자 정보 리소스를 제공하는 MCP 서버로, MCP 서버 개발 방법을 학습하고 테스트할 수 있습니다.\n\n## 🎯 프로젝트 목적\n\n- MCP 서버 개발 방법 학습\n- Tool과 Resource의 차이점 이해\n- LLM과의 연동 테스트\n- npm 패키지 배포 및 npx 실행 테스트\n\n## 설치\n\n```bash\nnpm install -g poc-node-mcp-server\n```\n\n또는 `npx`로 직접 실행:\n\n```bash\nnpx poc-node-mcp-server\n```\n\n## 제공하는 기능\n\n### Tools (도구)\n\n#### 1. add - 수학 계산\n두 숫자를 입력받아 그 합을 반환합니다.\n\n```json\n{\n  \"method\": \"tools/call\",\n  \"params\": {\n    \"name\": \"add\",\n    \"arguments\": {\n      \"a\": 5,\n      \"b\": 3\n    }\n  }\n}\n```\n\n#### 2. get_weather - 날씨 정보 조회\n도시 이름을 입력받아 해당 도시의 랜덤 날씨 정보를 반환합니다.\n\n```json\n{\n  \"method\": \"tools/call\",\n  \"params\": {\n    \"name\": \"get_weather\",\n    \"arguments\": {\n      \"city\": \"서울\"\n    }\n  }\n}\n```\n\n### Resources (리소스)\n\n#### 1. greeting - 인사말\n사용자 이름을 받아 인사말을 생성합니다.\n\n```\nURI: greeting://홍길동\n```\n\n#### 2. user_profile - 사용자 프로필\n사용자 이름을 받아 랜덤한 프로필 정보를 생성합니다.\n\n```\nURI: user_profile://김철수\n```\n\n## Gemini CLI 연동\n\n`.gemini/settings.json` 파일에 다음 설정을 추가하세요:\n\n```json\n{\n  \"mcpServers\": {\n    \"demo-mcp-server\": {\n      \"command\": \"npx\",\n      \"args\": [\"poc-node-mcp-server\"],\n      \"description\": \"POC MCP 서버 - 학습 및 테스트용 다양한 계산 도구와 사용자 정보 리소스 제공\"\n    }\n  }\n}\n```\n\n## 사용 예시\n\n### LLM과의 대화\n\n```\n사용자: \"5와 3을 더해줘\"\nLLM: add 도구를 사용하여 8을 반환\n\n사용자: \"서울의 날씨를 알려줘\"\nLLM: get_weather 도구를 사용하여 \"서울의 현재 날씨: 맑음, 기온: 15°C, 습도: 65%\" 반환\n\n사용자: \"홍길동에게 인사해줘\"\nLLM: greeting://홍길동 리소스에 접근하여 \"안녕하세요, 홍길동님!\" 반환\n\n사용자: \"김철수의 프로필을 보여줘\"\nLLM: user_profile://김철수 리소스에 접근하여 랜덤 프로필 정보 반환\n```\n\n## 개발\n\n### 로컬 개발 환경 설정\n\n```bash\n# 의존성 설치\nnpm install\n\n# TypeScript 빌드\nnpm run build\n\n# 개발 모드 실행\nnpm run dev\n\n# 테스트 실행\nnpm test\n```\n\n### 프로젝트 구조\n\n```\npoc-node-mcp-server/\n├── src/\n│   └── index.ts          # 메인 MCP 서버 코드\n├── dist/\n│   └── index.js          # 빌드된 JavaScript 파일\n├── test-mcp.js           # MCP 서버 테스트 스크립트\n├── package.json          # 프로젝트 설정\n├── tsconfig.json         # TypeScript 설정\n├── MCP_Learning_Guide.md # MCP 학습 가이드\n└── README.md            # 프로젝트 문서\n```\n\n## 📚 학습 자료\n\n이 프로젝트는 MCP 서버 개발을 위한 학습 자료입니다. `MCP_Learning_Guide.md` 파일에서 다음 내용을 학습할 수 있습니다:\n\n- MCP 서버 기본 개념\n- Tool vs Resource 차이점\n- LLM 활용을 위한 최적화 방법\n- Transport 방식 이해\n- 실제 구현 예제\n- Gemini CLI 연동 방법\n\n## ⚠️ 주의사항\n\n- 이 프로젝트는 **학습 및 테스트 목적**으로 제작되었습니다.\n- 실제 프로덕션 환경에서 사용하기에는 부족한 부분이 있을 수 있습니다.\n- 랜덤 데이터를 사용하므로 실제 데이터와 다를 수 있습니다.\n\n## 라이선스\n\nISC\n\n## 기여하기\n\n1. 이 저장소를 포크하세요\n2. 새로운 기능 브랜치를 만드세요 (`git checkout -b feature/amazing-feature`)\n3. 변경사항을 커밋하세요 (`git commit -m 'Add some amazing feature'`)\n4. 브랜치에 푸시하세요 (`git push origin feature/amazing-feature`)\n5. Pull Request를 생성하세요\n\n## 관련 링크\n\n- [MCP 공식 문서](https://modelcontextprotocol.io/)\n- [MCP SDK GitHub](https://github.com/modelcontextprotocol/sdk)\n- [Gemini CLI 문서](https://ai.google.dev/docs/gemini_cli) ","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fslicequeue%2Fpoc-node-mcp-server","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fslicequeue%2Fpoc-node-mcp-server","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fslicequeue%2Fpoc-node-mcp-server/lists"}