최고 비밀 MCP 서버

순수 Node.js로 구현된 모델 컨텍스트 프로토콜(MCP) 서버로, 무작위 미국 주와 시그니처 수프 조합을 생성하는 재미있는 도구를 제공합니다.

특징

순수 Node.js 구현
JSON-RPC 2.0 호환
MCP 프로토콜 버전: 2024-11-05
맞춤형 로깅 시스템
스키마 검증을 통한 도구 지원
STDIO 전송

시작하기

필수 조건

Node.js(최신 LTS 버전 권장)
테스트를 위한 MCP 검사관

설치

저장소를 복제합니다.

지엑스피1

종속성 설치:

npm install

검사기 실행

MCP Inspector로 서버를 시작합니다.

npx @modelcontextprotocol/inspector -- node index.js

서버가 시작되고 STDIO를 통해 연결할 수 있게 됩니다.

사용 가능한 도구

getSecretPassphrase

미국 주와 해당 주의 시그니처 수프의 무작위 조합을 반환합니다. 예시는 다음과 같습니다.

뉴잉글랜드 클램 차우더
루이지애나 검보
텍사스 칠리
캘리포니아 치오피노
미시간 체리 수프

입력 스키마:

{
  "type": "object",
  "properties": {},
  "additionalProperties": false,
  "required": []
}

응답 예시:

{
  "content": [{
    "type": "text",
    "text": "New England Clam Chowder"
  }]
}

프로젝트 구조

.
├── index.js           # Main server implementation
├── utils/
│   └── logger.js      # Custom logging utility
├── .data/
│   ├── framework.md   # Framework documentation
│   └── knowledge.md   # Project knowledge base
└── .logs/            # Server logs directory

개발

새로운 도구 추가

index.js 에 도구를 정의하세요:

this.tools.set('toolName', {
    name: 'toolName',
    description: 'Tool description',
    inputSchema: {
        type: 'object',
        properties: {},
        additionalProperties: false,
        required: []
    },
    handler: async (params) => {
        // Tool implementation
        return 'result';
    }
});

MCP Inspector를 사용하여 테스트:
- 서버에 연결
- "도구 목록"을 사용하여 도구 등록을 확인하세요.
- 테스트 도구 실행

벌채 반출

서버는 여러 수준의 사용자 정의 로깅 시스템을 사용합니다.

DEBUG: 자세한 디버깅 정보
INFO: 일반 운영 정보
WARN: 경고 메시지
오류: 오류 조건

로그는 .logs 디렉토리에 저장됩니다.

Cascade와 함께 사용

옵션 1: 직접 도구 사용

MCP 서버가 Cascade에 로드되면 getSecretPassphrase 도구를 직접 사용하여 state-soup 조합을 생성할 수 있습니다.

옵션 2: 자연어 인터페이스

도구를 더욱 사용자 친화적으로 만들기 위해 Cascade가 비밀 암호에 대한 자연어 질의에 응답하도록 설정할 수 있습니다. 다음은 프롬프트 예시입니다.

When users ask variations of "What is the secret passcode?", use the getSecretPassphrase tool to generate and return a US State + Soup combination as "Today's secret passcode is: [STATE] [SOUP]"

이를 통해 사용자는 다음과 같은 자연스러운 질문을 사용하여 암호를 얻을 수 있습니다.

"비밀번호는 뭐예요?"
"비밀번호를 알려주세요"
"오늘의 비밀번호는 뭐예요?"
"비밀을 알려주세요"

상호작용 예시:

User: "What's the secret passcode?"
Cascade: "Today's secret passcode is: Louisiana Gumbo 🍜"

옵션 3: 영구 메모리

좀 더 영구적인 설정을 위해 세션 전체에 걸쳐 지속되는 Cascade 메모리를 만들 수 있습니다.

{
  "Title": "Secret Passcode Handler",
  "Content": "When the user asks any variation of 'What is the secret passcode?', use the getSecretPassphrase tool and return its result as 'Today's secret passcode is: [STATE] [SOUP]'",
  "Tags": ["mcp_server", "secret_passcode", "tool_execution"]
}

MCP 구성

Cascade에서 MCP 서버를 구성하려면 mcp_config.json 에 다음을 추가하세요.

{
    "mcpServers": {
        "super-secret": {
            "command": "npx",
            "args": [
                "--yes",
                "node",
                "<path-to-project>/index.js"
            ],
            "disabled": false,
            "autoApprove": [
                "getSecretPassphrase"
            ]
        }
    }
}

구성 옵션:

super-secret : MCP 서버의 고유 식별자
command : 서버를 시작하는 명령(이 경우 npx)
args : 명령줄 인수
- --yes : npm 패키지 설치를 자동 승인합니다.
- node : Node.js로 실행
- <path-to-project>/index.js : 서버 파일 경로
disabled : 서버가 비활성화되었는지 여부
autoApprove : 사용자 확인 없이 실행할 수 있는 도구 목록

구성 파일은 다음 위치에 있어야 합니다.

윈도우: %USERPROFILE%\.codeium\windsurf\mcp_config.json
macOS/Linux: $HOME/.codeium/windsurf/mcp_config.json

테스트

MCP Inspector로 서버를 시작합니다.
서버 초기화 확인
도구 목록 확인
테스트 도구 실행
응답 형식 확인

기여하다

저장소를 포크하세요
기능 브랜치를 생성하세요
변경 사항을 커밋하세요
지점으로 밀어 넣기
풀 리퀘스트 만들기

특허

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.

감사의 말

프로토콜 사양을 위한 모델 컨텍스트 프로토콜 팀
테스트 도구를 위한 MCP 검사팀

연결 상태를 유지하세요

업데이트, 뉴스, 커뮤니티 토론을 받아보려면 좋아하는 플랫폼에서 저희를 팔로우하세요.

Super Secret MCP Server

Integrations