자동 도구 검색, Zod 스키마, HTTP 또는 stdio 전송 방식을 지원하는 Node.js 기반 MCP server 구축 도구입니다.
다른 이름 eliware/mcp-server, @eliware/mcp-server
- 스타
- 0
- Tools
- —
- 다운로드, 30일
- 824
- 최신 버전
- —
- 마지막 커밋
- 2026년 10월 27일
- 라이선스
- MIT
@eliware/mcp MCP란?
@eliware/mcp은(는) MCP server입니다. 자동 도구 검색, Zod 스키마, HTTP 또는 stdio 전송 방식을 지원하는 Node.js 기반 MCP server 구축 도구입니다.
프로젝트 README에서 생성된 요약
@eliware/mcp MCP server 정보
이 Node.js 패키지를 사용하면 순수 ESM 방식으로 Model Context Protocol server를 구축할 수 있습니다. 도구 검색 및 구조화된 입력 검증 구현이 필요한 Node.js 26 이상 사용자에게 적합하도록 설계되었습니다. 이 프레임워크는 stdio와 streamable HTTP 전송 방식을 모두 지원하지만, SSE 방식의 HTTP는 지원하지 않습니다.
개발자는 패키지에서 z 객체를 직접 임포트하여 Zod를 이용한 도구 입력 스키마를 정의할 수 있습니다. 시스템은 tools 디렉토리에 있는 .mjs 모듈을 스캔하여 도구 검색을 자동화합니다. 보안을 위해 정적 bearer token, bearer passthrough, 일반 OAuth2 지원 등 다양한 인증 옵션을 제공합니다. 또한 주입 가능한 context와 원격 연결을 위한 TLS를 지원합니다.
사용하려면 npm을 통해 패키지를 설치하고 mcpServer 함수를 사용하여 server를 설정합니다. MCP client가 protocol revision 2026-07-28 및 선택한 특정 전송 방식을 지원하는지 반드시 확인해야 합니다.
활용 사례
- 1도구 등록 자동화특정 디렉토리에 .mjs 파일을 배치하여 여러 도구 모듈을 자동으로 로드할 수 있습니다.
- 2도구 입력 검증Zod 스키마를 사용하여 도구로 전송되는 데이터가 엄격한 구조를 따르도록 보장할 수 있습니다.
- 3원격 연결 보안bearer token 또는 OAuth2 introspection을 사용하여 서버를 무단 액세스로부터 보호할 수 있습니다.
- 4유연한 통신 구현로컬 stdio 통신 또는 원격 streamable HTTP 전송 방식 중 선택할 수 있습니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
@eliware/mcp MCP 설치 방법
형식 확인: 2026년 11월 10일Cursor에 추가Goose에 추가Claude Code에 @eliware/mcp MCP 설치
$ claude mcp add mcp-server -- npx -y @eliware/mcp-serverCursor에 @eliware/mcp MCP 설치
~/.cursor/mcp.json
{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"@eliware/mcp-server"
]
}
}
}VS Code에 @eliware/mcp MCP 설치
.vscode/mcp.json
{
"servers": {
"mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@eliware/mcp-server"
]
}
}
}VS Code CLI에 @eliware/mcp MCP 설치
$ code --add-mcp '{"name":"mcp-server","type":"stdio","command":"npx","args":["-y","@eliware/mcp-server"]}'Claude Desktop에 @eliware/mcp MCP 설치
claude_desktop_config.json
{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"@eliware/mcp-server"
]
}
}
}Codex에 @eliware/mcp MCP 설치
$ codex mcp add mcp-server -- npx -y @eliware/mcp-serverCodex config.toml에 @eliware/mcp MCP 설치
~/.codex/config.toml
[mcp_servers.mcp-server] command = "npx" args = ["-y", "@eliware/mcp-server"]
Gemini CLI에 @eliware/mcp MCP 설치
$ gemini mcp add -s user mcp-server npx -- -y @eliware/mcp-serverGemini settings.json에 @eliware/mcp MCP 설치
~/.gemini/settings.json
{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"@eliware/mcp-server"
]
}
}
}자동 검사
2026년 11월 15일에 실행됨전체 보고서 →자동 검사를 통과했습니다. 이는 보안 감사가 아닙니다. 코드를 직접 읽고 서버에 필요한 최소한의 권한만 부여하십시오. 검사 방식
- 소스 저장소 연결 및 접근 가능eliware/mcp-server is public and reachablegithub.com/eliware/mcp-server ↗통과
- 패키지가 이 저장소를 소스로 명시@eliware/mcp-server names eliware/mcp-server as sourcenpmjs.com/package/@eliware/mcp-server ↗통과
- 빌드 출처(Sigstore 증명)Sigstore attestation for @eliware/mcp-servernpmjs.com/package/@eliware/mcp-server/v/15.0.1#provenance ↗통과
- 오픈 소스 라이선스 (OSI)MITspdx.org/licenses/MIT.html ↗통과
- 최근 1년 내 커밋 또는 릴리스Last commit or release 2026-10-27github.com/eliware/mcp-server ↗통과
- OpenSSF Scorecard검사되지 않음
- 패키지 이름이 인기 패키지와 유사하지 않음No popular package one edit away from @eliware/mcp-server통과
- 패키지 및 해당 종속성에 중요한 보안 권고 없음검사되지 않음
- 모델에 대한 숨겨진 지침 없음0 tool descriptions and the README read; no override phrases, credential paths or hidden characters통과
- 파괴적인 도구에 라벨 표시됨검사되지 않음
- 원격 엔드포인트가 MCP 핸드셰이크에 응답검사되지 않음
README
GitHub에서 보기@eliware/mcp-server

Pure-ESM Node.js MCP server with automatic tool discovery, Streamable HTTP and stdio transports, TLS, Zod schemas, injectable context, bearer authentication, and generic OAuth2 support.
Table of Contents
- Features
- Requirements
- Setup
- Usage
- Development
- Testing
- Troubleshooting
- Security
- API
- Packaging
- Examples
- Support
- Links
- License
Features
Create MCP servers with Streamable HTTP or stdio, discovered tool modules, Zod input schemas, shared context, and optional authentication.
Requirements
Use Node.js 26 or later. Use an MCP client that supports protocol revision 2026-07-28 and the selected transport.
Setup
Install the package with npm install @eliware/mcp-server. Read the setup guide before you create a server.
Usage
Create a server with mcpServer() and add tool modules in tools/. Read the usage guide, configuration guide, and authentication guide.
Browse the documentation index, specifications index, and release notes.
Tools
Add one .mjs module for each tool in tools/. Read the tool guide for registration and context details.
Resources
The package does not scan resource files. Add resources to the SDK server inside a tool module. Read the tool guide.
Prompts
The package does not scan prompt files. Add prompts to the SDK server inside a tool module. Read the tool guide.
Transport
Use Streamable HTTP or stdio. The package does not support HTTP with SSE. Read the protocol requirements.
Authentication
Select no authentication, a static bearer token, bearer passthrough, or OAuth2 introspection. Use HTTPS for OAuth endpoints. Read the authentication guide.
Schemas
Import z from @eliware/mcp-server to define tool input schemas. Read the tool guide.
Development
Run npm ci to install locked dependencies. Run npm run format to format files. Run npm run format:check to check file formatting.
Run npm run lint for lint checks. Run npm run audit for dependency checks. Run npm run typecheck to check TypeScript declarations.
Testing
Run npm test for aggregate validation. Run npm run pack to check package contents.
Troubleshooting
Read the troubleshooting guide for setup and runtime issues.
Security
Keep tokens, OAuth client secrets, and TLS keys in environment variables or secret files. Use HTTPS and explicit authentication for remote access.
API
Read the API reference for exports, options, and result types.
Packaging
The npm package includes src/, docs/, README.md, AGENTS.md, LICENSE, RELEASE_NOTES.md, examples/, specs/, and .env.example.
Use numeric MAJOR.MINOR.PATCH versions and a v<version> tag for each release. Run npm run pack to check package contents. The npm workflow publishes approved tagged releases.
Examples
Read examples/README.md for server and tool examples.
Support
For help, questions, or to chat with the author and community, visit:
Links
License
@eliware/mcp MCP 질문
@eliware/mcp MCP를 Claude Code에 추가하려면 어떻게 하나요?
터미널에서 claude mcp add mcp-server -- npx -y @eliware/mcp-server를 실행합니다. 모든 프로젝트에서 사용할 수 있게 하려면 --scope user를 추가합니다.
@eliware/mcp MCP를 Cursor에 추가하려면 어떻게 하나요?
~/.cursor/mcp.json를 열고 mcpServers 아래에 서버를 추가합니다. 위 설치 섹션에 표시된 Cursor 구성을 사용합니다.
Node.js 요구 사항은 무엇인가요?
Node.js 26 이상의 버전을 사용해야 합니다.
이 server는 SSE 방식의 HTTP를 지원하나요?
아니요, 이 패키지는 streamable HTTP와 stdio를 지원하지만 SSE 방식의 HTTP는 지원하지 않습니다.
server에 도구를 어떻게 추가하나요?
tools/ 디렉토리에 각 도구별로 .mjs 모듈을 하나씩 배치하여 추가할 수 있습니다.
입력 스키마에 Zod를 사용할 수 있나요?
네, @eliware/mcp-server에서 z 객체를 임포트하여 도구 입력 스키마를 정의할 수 있습니다.


