[{"_1":2,"_306":-5,"_307":-5},"loaderData",{"_3":4,"_24":25,"_213":214},"root",{"_5":6,"_7":8},"toasts",[],"visitor",{"_9":10,"_11":12},"viewportWidth",1280,"visitorSession",{"_13":14,"_16":17,"_18":-5,"_19":20,"_21":22,"_23":-5},"attributes",[15],"bot","id",26956153,"membership","referenceId","019aaa59-d4ed-74ec-91a5-a5958f55d5bf","unreadReleaseNotesCount",2,"userAccount","routes/_public/mcp/servers/~namespace/~slug/_pages/_layout",{"_26":27,"_28":-5,"_29":30,"_31":43,"_131":132,"_212":118},"availableLocales",[],"githubUser","locale",{"_31":32,"_39":40,"_41":42},"mcpServer",{"_33":34,"_35":36,"_37":38},"description","A boilerplate project for quickly developing Model Context Protocol (MCP) servers using TypeScript SDK, featuring example tools (calculator, greet), resources (server info), and AI image generation capabilities via Hugging Face.","displayName","TypeScript MCP Server Boilerplate","readme","# TypeScript MCP Server 보일러플레이트\n\nTypeScript MCP SDK를 활용하여 Model Context Protocol (MCP) 서버를 빠르게 개발할 수 있는 보일러플레이트 프로젝트입니다.\n\n## 📁 프로젝트 구조\n\n```\ntypescript-mcp-server-boilerplate/\n├── src/\n│ └── index.ts # MCP 서버 메인 진입점\n├── build/ # 컴파일된 JavaScript 파일 (빌드 후 생성)\n├── package.json # 프로젝트 의존성 및 스크립트\n├── tsconfig.json # TypeScript 설정\n└── README.md # 프로젝트 문서\n```\n\n## 🚀 시작하기\n\n### 1. 의존성 설치\n\n```bash\nnpm install\n```\n\n### 2. 서버 이름 설정\n\n`src/index.ts` 파일에서 서버 이름을 수정하세요:\n\n```typescript\nconst server = new McpServer({\n name: 'typescript-mcp-server', // 여기를 원하는 서버 이름으로 변경\n version: '1.0.0',\n // 활성화 하고자 하는 기능 설정\n capabilities: {\n tools: {},\n resources: {}\n }\n})\n```\n\n> 💡 **팁**: 현재 보일러플레이트에는 이미 계산기와 인사 도구, 그리고 서버 정보 리소스가 예시로 구현되어 있습니다.\n\n### 3. 빌드\n\n```bash\nnpm run build\n```\n\n### 4. 실행\n\n```bash\nnode build/index.js\n```\n\n빌드가 성공하면 `build/` 디렉토리에 컴파일된 JavaScript 파일이 생성되고, 서버가 MCP 클라이언트의 연결을 대기합니다.\n\n## 🛠️ 개발 가이드\n\n### MCP 도구(Tool) 추가하기\n\nMCP 서버에 새로운 도구를 추가하려면 `server.tool()` 메서드에 **Zod 스키마를 직접** 정의하여 등록합니다:\n\n```typescript\nimport { z } from 'zod'\n\n// 계산기 도구 추가\nserver.tool(\n 'calculator',\n {\n operation: z\n .enum(['add', 'subtract', 'multiply', 'divide'])\n .describe('수행할 연산 (add, subtract, multiply, divide)'),\n a: z.number().describe('첫 번째 숫자'),\n b: z.number().describe('두 번째 숫자')\n },\n async ({ operation, a, b }) => {\n // 연산 수행\n let result: number\n switch (operation) {\n case 'add':\n result = a + b\n break\n case 'subtract':\n result = a - b\n break\n case 'multiply':\n result = a * b\n break\n case 'divide':\n if (b === 0) throw new Error('0으로 나눌 수 없습니다')\n result = a / b\n break\n default:\n throw new Error('지원하지 않는 연산입니다')\n }\n\n const operationSymbols = {\n add: '+',\n subtract: '-',\n multiply: '×',\n divide: '÷'\n } as const\n\n const operationSymbol =\n operationSymbols[operation as keyof typeof operationSymbols]\n\n return {\n content: [\n {\n type: 'text',\n text: `${a} ${operationSymbol} ${b} = ${result}`\n }\n ]\n }\n }\n)\n```\n\n#### 더 복잡한 도구 예시\n\n```typescript\n// 날씨 정보 조회 도구\nserver.tool(\n 'get_weather',\n {\n city: z.string().describe('날씨를 조회할 도시명'),\n unit: z\n .enum(['celsius', 'fahrenheit'])\n .optional()\n .default('celsius')\n .describe('온도 단위 (기본값: celsius)')\n },\n async ({ city, unit }) => {\n try {\n // 실제 날씨 API 호출 로직 (예시)\n const weatherData = await fetchWeatherData(city, unit)\n\n return {\n content: [\n {\n type: 'text',\n text: `${city}의 현재 날씨:\n온도: ${weatherData.temperature}°${unit === 'celsius' ? 'C' : 'F'}\n날씨: ${weatherData.condition}\n습도: ${weatherData.humidity}%\n풍속: ${weatherData.windSpeed}km/h`\n }\n ]\n }\n } catch (error) {\n throw new Error(\n `날씨 정보를 가져올 수 없습니다: ${(error as Error).message}`\n )\n }\n }\n)\n\n// 도우미 함수\nasync function fetchWeatherData(city: string, unit: string) {\n // 실제 날씨 API 호출 구현\n // 여기서는 예시 데이터 반환\n return {\n temperature: unit === 'celsius' ? 22 : 72,\n condition: '맑음',\n humidity: 65,\n windSpeed: 12\n }\n}\n```\n\n### 리소스 추가하기\n\nMCP 서버에 리소스를 추가하여 외부 데이터나 파일에 대한 접근을 제공할 수 있습니다:\n\n```typescript\n// 리소스 등록\nserver.resource(\n 'example-file',\n 'file://example.txt',\n {\n name: '예시 텍스트 파일',\n description: '예시 텍스트 파일 설명',\n mimeType: 'text/plain'\n },\n async () => {\n return {\n contents: [\n {\n uri: 'file://example.txt',\n mimeType: 'text/plain',\n text: '예시 파일 내용입니다.'\n }\n ]\n }\n }\n)\n\n// 동적 리소스 예시\nserver.resource(\n 'app-settings',\n 'config://settings',\n {\n name: '애플리케이션 설정',\n description: '애플리케이션의 현재 설정 정보',\n mimeType: 'application/json'\n },\n async () => {\n const settings = {\n theme: 'dark',\n language: 'ko-KR',\n notifications: true,\n lastUpdated: new Date().toISOString()\n }\n\n return {\n contents: [\n {\n uri: 'config://settings',\n mimeType: 'application/json',\n text: JSON.stringify(settings, null, 2)\n }\n ]\n }\n }\n)\n```\n\n## 🎨 이미지 생성 도구\n\n이 서버에는 AI를 사용한 텍스트-이미지 생성 도구가 포함되어 있습니다.\n\n### 환경 변수 설정\n\n이미지 생성 기능을 사용하려면 Hugging Face API 토큰이 필요합니다.\n\n**방법 1: .env 파일 사용 (권장)**\n\n프로젝트 루트에 `.env` 파일을 생성하고 토큰을 추가하세요:\n\n```bash\nHF_TOKEN=your_huggingface_token_here\n```\n\n**방법 2: 환경 변수로 직접 설정**\n\n```bash\n# Windows (PowerShell)\n$env:HF_TOKEN=\"your_huggingface_token_here\"\n\n# macOS/Linux\nexport HF_TOKEN=\"your_huggingface_token_here\"\n```\n\n> 💡 **Hugging Face 토큰 발급하기**: [Hugging Face 설정](https://huggingface.co/settings/tokens)에서 새 토큰을 생성할 수 있습니다.\n> \n> ⚠️ **보안 주의**: `.env` 파일은 `.gitignore`에 포함되어 있어 Git에 커밋되지 않습니다.\n\n### 사용 예시\n\n```typescript\n// Cursor MCP에서 사용:\n// \"우주비행사가 말을 타고 있는 이미지를 생성해줘\"\n// \"beautiful sunset over mountains\"\n```\n\n이미지는 base64 인코딩된 PNG 형식으로 반환됩니다.\n\n## 📦 주요 의존성\n\n- **@modelcontextprotocol/sdk**: MCP 프로토콜 구현을 위한 공식 SDK\n- **@huggingface/inference**: Hugging Face AI 모델 추론을 위한 클라이언트\n- **dotenv**: 환경 변수 관리를 위한 라이브러리\n- **zod**: TypeScript 우선 스키마 검증 라이브러리\n- **typescript**: TypeScript 컴파일러\n\n## 🔧 스크립트\n\n- `npm run build`: TypeScript를 JavaScript로 컴파일하고 실행 권한 설정\n\n## 📋 사용 예시\n\n### 완전한 서버 예시\n\n```typescript\nimport { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js'\nimport { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js'\nimport { z } from 'zod'\n\n// 서버 생성\nconst server = new McpServer({\n name: 'my-mcp-server',\n version: '1.0.0',\n capabilities: {\n tools: {},\n resources: {}\n }\n})\n\n// 간단한 인사 도구\nserver.tool(\n 'greet',\n {\n name: z.string().describe('인사할 사람의 이름'),\n language: z\n .enum(['ko', 'en'])\n .optional()\n .default('ko')\n .describe('인사 언어 (기본값: ko)')\n },\n async ({ name, language }) => {\n const greeting =\n language === 'ko' ? `안녕하세요, ${name}님!` : `Hello, ${name}!`\n\n return {\n content: [\n {\n type: 'text',\n text: greeting\n }\n ]\n }\n }\n)\n\n// 시스템 정보 리소스\nserver.resource(\n 'system-info',\n 'system://info',\n {\n name: '시스템 정보',\n description: '서버의 현재 상태 및 시스템 정보',\n mimeType: 'application/json'\n },\n async () => {\n const systemInfo = {\n server: 'my-mcp-server',\n version: '1.0.0',\n timestamp: new Date().toISOString(),\n uptime: process.uptime()\n }\n\n return {\n contents: [\n {\n uri: 'system://info',\n mimeType: 'application/json',\n text: JSON.stringify(systemInfo, null, 2)\n }\n ]\n }\n }\n)\n\n// 서버 시작\nasync function main() {\n const transport = new StdioServerTransport()\n await server.connect(transport)\n console.error('MCP 서버가 시작되었습니다')\n}\n\nmain().catch(console.error)\n```\n\n## 🔧 Cursor MCP 연결\n\n개발한 MCP 서버를 Cursor에서 테스트할 수 있습니다:\n\n### 설정 파일 수정\n\n`./.cursor/mcp.json` 파일을 편집합니다:\n\n```json\n{\n \"mcpServers\": {\n \"typescript-mcp-server\": {\n \"command\": \"node\",\n \"args\": [\"/ABSOLUTE/PATH/TO/YOUR/PROJECT/build/index.js\"]\n }\n }\n}\n```\n\n> **주의**: 절대 경로를 사용해야 합니다. `pwd` 명령어로 현재 경로를 확인하세요.\n\n### 테스트 명령어\n\nCursor MCP에서 다음과 같이 테스트해볼 수 있습니다:\n\n- \"5 더하기 3은 얼마야?\" (계산기 도구 테스트)\n- \"안녕하세요 라고 인사해줘\" (인사 도구 테스트)\n- 서버 정보 리소스 조회\n\n## 🔗 참고 자료\n\n- [Model Context Protocol 공식 문서](https://modelcontextprotocol.io/)\n- [MCP TypeScript SDK](https://github.com/modelcontextprotocol/typescript-sdk)\n- [Node.js MCP 서버 개발 가이드](https://modelcontextprotocol.io/docs/develop/build-server#node)\n- [Zod 문서](https://zod.dev/)\n\n## 📄 라이선스\n\nMIT\n","name","English","tag","en-US",{"_44":45,"_13":46,"_53":34,"_54":34,"_35":36,"_16":55,"_56":57,"_69":70,"_77":-5,"_78":79,"_80":-5,"_81":82,"_121":122,"_126":-5,"_64":110,"_127":79,"_67":128,"_129":130},"addedAt","2025-11-02T22:05:03.952874Z",[47,48,49,50,51,52],"category:developer-tools","category:image-and-video-processing","environment:network","hosting:hybrid","language:typescript","license_grade:f","descriptionMarkdown","descriptionPlainText",13299,"integrations",[58],{"_59":60,"_33":66,"_67":68},"brand",{"_61":62,"_39":63,"_64":65},"logoSvgPath","M12.025 1.13c-5.77 0-10.449 4.647-10.449 10.378 0 1.112.178 2.181.503 3.185.064-.222.203-.444.416-.577a.96.96 0 0 1 .524-.15c.293 0 .584.124.84.284.278.173.48.408.71.694.226.282.458.611.684.951v-.014c.017-.324.106-.622.264-.874s.403-.487.762-.543c.3-.047.596.06.787.203s.31.313.4.467c.15.257.212.468.233.542.01.026.653 1.552 1.657 2.54.616.605 1.01 1.223 1.082 1.912.055.537-.096 1.059-.38 1.572.637.121 1.294.187 1.967.187.657 0 1.298-.063 1.921-.178-.287-.517-.44-1.041-.384-1.581.07-.69.465-1.307 1.081-1.913 1.004-.987 1.647-2.513 1.657-2.539.021-.074.083-.285.233-.542.09-.154.208-.323.4-.467a1.08 1.08 0 0 1 .787-.203c.359.056.604.29.762.543s.247.55.265.874v.015c.225-.34.457-.67.683-.952.23-.286.432-.52.71-.694.257-.16.547-.284.84-.285a.97.97 0 0 1 .524.151c.228.143.373.388.43.625l.006.04a10.3 10.3 0 0 0 .534-3.273c0-5.731-4.678-10.378-10.449-10.378M8.327 6.583a1.5 1.5 0 0 1 .713.174 1.487 1.487 0 0 1 .617 2.013c-.183.343-.762-.214-1.102-.094-.38.134-.532.914-.917.71a1.487 1.487 0 0 1 .69-2.803m7.486 0a1.487 1.487 0 0 1 .689 2.803c-.385.204-.536-.576-.916-.71-.34-.12-.92.437-1.103.094a1.487 1.487 0 0 1 .617-2.013 1.5 1.5 0 0 1 .713-.174m-10.68 1.55a.96.96 0 1 1 0 1.921.96.96 0 0 1 0-1.92m13.838 0a.96.96 0 1 1 0 1.92.96.96 0 0 1 0-1.92M8.489 11.458c.588.01 1.965 1.157 3.572 1.164 1.607-.007 2.984-1.155 3.572-1.164.196-.003.305.12.305.454 0 .886-.424 2.328-1.563 3.202-.22-.756-1.396-1.366-1.63-1.32q-.011.001-.02.006l-.044.026-.01.008-.03.024q-.018.017-.035.036l-.032.04a1 1 0 0 0-.058.09l-.014.025q-.049.088-.11.19a1 1 0 0 1-.083.116 1.2 1.2 0 0 1-.173.18q-.035.029-.075.058a1.3 1.3 0 0 1-.251-.243 1 1 0 0 1-.076-.107c-.124-.193-.177-.363-.337-.444-.034-.016-.104-.008-.2.022q-.094.03-.216.087-.06.028-.125.063l-.13.074q-.067.04-.136.086a3 3 0 0 0-.135.096 3 3 0 0 0-.26.219 2 2 0 0 0-.12.121 2 2 0 0 0-.106.128l-.002.002a2 2 0 0 0-.09.132l-.001.001a1.2 1.2 0 0 0-.105.212q-.013.036-.024.073c-1.139-.875-1.563-2.317-1.563-3.203 0-.334.109-.457.305-.454m.836 10.354c.824-1.19.766-2.082-.365-3.194-1.13-1.112-1.789-2.738-1.789-2.738s-.246-.945-.806-.858-.97 1.499.202 2.362c1.173.864-.233 1.45-.685.64-.45-.812-1.683-2.896-2.322-3.295s-1.089-.175-.938.647 2.822 2.813 2.562 3.244-1.176-.506-1.176-.506-2.866-2.567-3.49-1.898.473 1.23 2.037 2.16c1.564.932 1.686 1.178 1.464 1.53s-3.675-2.511-4-1.297c-.323 1.214 3.524 1.567 3.287 2.405-.238.839-2.71-1.587-3.216-.642-.506.946 3.49 2.056 3.522 2.064 1.29.33 4.568 1.028 5.713-.624m5.349 0c-.824-1.19-.766-2.082.365-3.194 1.13-1.112 1.789-2.738 1.789-2.738s.246-.945.806-.858.97 1.499-.202 2.362c-1.173.864.233 1.45.685.64.451-.812 1.683-2.896 2.322-3.295s1.089-.175.938.647-2.822 2.813-2.562 3.244 1.176-.506 1.176-.506 2.866-2.567 3.49-1.898-.473 1.23-2.037 2.16c-1.564.932-1.686 1.178-1.464 1.53s3.675-2.511 4-1.297c.323 1.214-3.524 1.567-3.287 2.405.238.839 2.71-1.587 3.216-.642.506.946-3.49 2.056-3.522 2.064-1.29.33-4.568 1.028-5.713-.624","Hugging Face","slug","huggingface","Provides text-to-image generation capabilities using Hugging Face AI models through their inference API, returning base64-encoded PNG images from text prompts.","uid","tfovni2tlq","namespace",{"_71":72,"_64":76},"owner",{"_73":74},"githubAccount",{"_75":76},"login","rrq974kf","readmeMarkdown","recentUsage",0,"redditPostExternalId","repository",{"_83":84,"_95":96,"_99":100,"_116":-5,"_117":118,"_119":-5,"_120":-5},"argumentsJsonSchema",{"_85":86,"_92":93,"_90":94},"properties",{"_87":88},"HF_TOKEN",{"_33":89,"_90":91},"Your Hugging Face API token for image generation functionality","type","string","required",[],"object","githubProject",{"_37":38,"_97":98},"url","https://github.com/rrq974kf/my-mcp-server-251027","githubRepository",{"_101":102,"_103":104,"_105":106,"_16":107,"_108":109,"_39":110,"_71":111,"_113":79,"_114":-5,"_115":79},"defaultBranch","main","fullName","rrq974kf/my-mcp-server-251027","githubTreeId",3116097,32020,"language","TypeScript","my-mcp-server-251027",{"_75":76,"_67":112},"thhcgy4qji","recentStargazers","spdxLicense","stargazers","glamaJson","inspectable",false,"npmPackage","supportedPlatforms","scores",{"_123":79,"_124":-5,"_125":-5},"license","quality","security","simpleIcon","toolCount","ko31h0yxoc","updatedAt","2025-11-19T01:37:17.056935Z","meta",[133,136,138,145,148,150,153,156,159,162,165,167,170,173,175,177,179,181,183],{"_134":135},"title","TypeScript MCP Server Boilerplate | Glama",{"_137":34,"_39":33},"content",{"_139":140,"_141":142,"_143":144},"href","https://glama.ai/mcp/servers/@rrq974kf/my-mcp-server-251027","rel","canonical","tagName","link",{"_137":36,"_146":147},"property","og:title",{"_137":34,"_146":149},"og:description",{"_137":151,"_146":152},"https://glama.ai/logo.png","og:logo",{"_137":154,"_146":155},"https://glama.ai/mcp/servers/@rrq974kf/my-mcp-server-251027/og-image","og:image",{"_137":157,"_146":158},"630","og:image:height",{"_137":160,"_146":161},"1200","og:image:width",{"_137":163,"_146":164},"website","og:type",{"_137":140,"_146":166},"og:url",{"_137":168,"_146":169},"Glama – MCP Hosting Platform","og:site_name",{"_137":171,"_39":172},"summary_large_image","twitter:card",{"_137":168,"_39":174},"twitter:title",{"_137":34,"_39":176},"twitter:description",{"_137":154,"_39":178},"twitter:image",{"_137":157,"_39":180},"twitter:image:height",{"_137":160,"_39":182},"twitter:image:width",{"_184":185},"script:ld+json",{"_186":187,"_188":189},"@context","http://schema.org","@graph",[190],{"_186":191,"_192":193,"_194":195},"https://schema.org","@type","BreadcrumbList","itemListElement",[196,203,206,210],{"_192":197,"_198":199,"_39":200,"_201":202},"ListItem","item","https://glama.ai/","Glama","position",1,{"_192":197,"_198":204,"_39":205,"_201":22},"https://glama.ai/mcp","MCP",{"_192":197,"_198":207,"_39":208,"_201":209},"https://glama.ai/mcp/servers","Servers",3,{"_192":197,"_198":140,"_39":36,"_201":211},4,"visitorIsMaintainer","routes/_public/mcp/servers/~namespace/~slug/_pages/_explorer/blob/~commit/~/_route",{"_215":216,"_31":222,"_239":240,"_131":252,"_249":276,"_277":278},"blob",{"_137":217,"_218":219,"_220":221},"\n","fileName","spaceship.svg","size",2870,{"_44":45,"_13":223,"_53":34,"_54":34,"_35":36,"_16":55,"_56":224,"_69":227,"_77":-5,"_78":79,"_80":-5,"_81":230,"_121":238,"_126":-5,"_64":110,"_127":79,"_67":128,"_129":130},[47,48,49,50,51,52],[225],{"_59":226,"_33":66,"_67":68},{"_61":62,"_39":63,"_64":65},{"_71":228,"_64":76},{"_73":229},{"_75":76},{"_83":231,"_95":235,"_99":236,"_116":-5,"_117":118,"_119":-5,"_120":-5},{"_85":232,"_92":234,"_90":94},{"_87":233},{"_33":89,"_90":91},[],{"_37":38,"_97":98},{"_101":102,"_103":104,"_105":106,"_16":107,"_108":109,"_39":110,"_71":237,"_113":79,"_114":-5,"_115":79},{"_75":76,"_67":112},{"_123":79,"_124":-5,"_125":-5},"member",{"_241":242,"_245":246,"_247":219,"_105":106,"_248":-5,"_249":219,"_250":251,"_220":221,"_90":215},"commit",{"_243":244},"sha","8db584e815689d11d08d51d98152792a84ee8cc3","contentStoredObjectPointerId",19855318,"fullPath","indexable","path","safeToDisplayAsText",true,[253,255,257,259,261,262,263,265,266,267,268,269,270,271,272,273,274,275],{"_134":254},"spaceship.svg | TypeScript MCP Server Boilerplate | Glama",{"_137":256,"_39":33},"Enterprise-grade security, privacy, and features like agents, MCP, prompt templates, and more.",{"_139":258,"_141":142,"_143":144},"https://glama.ai/mcp/servers/@rrq974kf/my-mcp-server-251027/blob/8db584e815689d11d08d51d98152792a84ee8cc3/",{"_137":260,"_146":147},"spaceship.svg | TypeScript MCP Server Boilerplate",{"_137":256,"_146":149},{"_137":151,"_146":152},{"_137":264,"_146":155},"https://glama.ai/generated-images/og?title=spaceship.svg+%7C+TypeScript+MCP+Server+Boilerplate",{"_137":157,"_146":158},{"_137":160,"_146":161},{"_137":163,"_146":164},{"_137":258,"_146":166},{"_137":168,"_146":169},{"_137":171,"_39":172},{"_137":168,"_39":174},{"_137":256,"_39":176},{"_137":264,"_39":178},{"_137":157,"_39":180},{"_137":160,"_39":182},"","treeMembers",[279,283,286,289,292,295,298,301,303],{"_241":280,"_247":281,"_249":281,"_90":282},{"_243":244},".cursor","tree",{"_241":284,"_247":285,"_249":285,"_90":282},{"_243":244},"src",{"_241":287,"_247":288,"_249":288,"_90":215},{"_243":244},".gitignore",{"_241":290,"_247":291,"_249":291,"_90":215},{"_243":244},"package.json",{"_241":293,"_247":294,"_249":294,"_90":215},{"_243":244},"package-lock.json",{"_241":296,"_247":297,"_249":297,"_90":215},{"_243":244},"README.md",{"_241":299,"_247":300,"_249":300,"_90":215},{"_243":244},"smithery.yaml",{"_241":302,"_247":219,"_249":219,"_90":215},{"_243":244},{"_241":304,"_247":305,"_249":305,"_90":215},{"_243":244},"tsconfig.json","actionData","errors"]

MCP directory API