서브마이API

macOS 키체인을 사용하여 여러 프로젝트에서 API 키를 안전하게 저장하고 액세스할 수 있는 개인 MCP(모델 컨텍스트 프로토콜) 서버입니다.

중요 : ServeMyAPI는 macOS 전용 도구로, 보안 저장을 위해 macOS 키체인을 사용합니다. Windows 또는 Linux 운영 체제와는 호환되지 않습니다. 자세한 내용은 보안 참고 사항 섹션을 참조하세요.

개요

ServeMyAPI를 사용하면 macOS 키체인에 API 키를 안전하게 저장하고 일관된 MCP 인터페이스를 통해 액세스할 수 있습니다. 이를 통해 다음과 같은 작업을 쉽게 수행할 수 있습니다.

• API 키를 안전하게 저장하세요(.env 파일이나 구성 파일에는 표시되지 않습니다)
• 여러 프로젝트에서 동일한 키에 액세스
• 자연어를 사용하여 키를 저장하고 검색합니다(Claude와 같은 LLM과 함께 사용하는 경우)
• 서비스에 액세스해야 할 때 AI 비서에게 직접 키를 제공합니다.

왜 .ENV 파일보다 ServeMyAPI를 사용해야 할까요?

기존 .ENV 파일 대신 ServeMyAPI를 사용하면 여러 가지 일반적인 문제가 해결됩니다.

1. GitHub 보안 충돌 :
   • 보안을 위해 .ENV 파일은 Git 저장소에서 제외해야 합니다(.gitignore를 통해).
   • 이는 중요한 구성이 협력자와 LLM에게 보이지 않는 "숨겨진 컨텍스트" 문제를 생성합니다.
   • 새로운 개발자는 종종 올바른 환경 변수를 설정하는 데 어려움을 겪습니다.
2. LLM 통합 과제 :
   • Claude와 같은 LLM은 보안 제약으로 인해 .ENV 파일에 직접 액세스할 수 없습니다.
   • LLM이 작업을 완료하기 위해 API 키가 필요한 경우 종종 수동 해결 방법이 필요합니다.
   • ServeMyAPI를 사용하면 AI 도우미가 자연어로 키를 요청할 수 있습니다.
3. 프로젝트 간 일관성 :
   • .ENV 파일을 사용하는 경우 일반적으로 여러 프로젝트에 걸쳐 API 키를 복제해야 합니다.
   • 키가 변경되면 여러 파일을 업데이트해야 합니다.
   • ServeMyAPI는 모든 프로젝트에서 접근 가능한 중앙 저장 위치를 제공합니다.

이 접근 방식을 사용하면 두 가지 장점을 모두 누릴 수 있습니다. 즉, AI 도구의 가시성과 접근성을 희생하지 않고도 민감한 자격 증명을 안전하게 저장할 수 있습니다.

특징

• macOS 키체인에 API 키를 안전하게 저장
• 키 저장, 검색, 나열 및 삭제를 위한 간단한 MCP 도구
• stdio 및 HTTP/SSE 전송 모두 지원
• 모든 MCP 클라이언트(Claude Desktop 등)와 호환됩니다.

설치

지엑스피1

용법

stdio 서버로 실행

특히 Claude Desktop으로 작업할 때 ServeMyAPI를 사용하는 가장 간단한 방법은 다음과 같습니다.

HTTP 서버로 실행

HTTP 액세스가 필요한 애플리케이션의 경우:

이렇게 하면 서버가 포트 3000(또는 PORT 환경 변수에 지정된 포트)에서 시작됩니다.

대장간 사용

ServeMyAPI는 Smithery 에서 호스팅 서비스로 제공됩니다.

자세한 내용은 Smithery API 문서를 참조하세요.

MCP 클라이언트 구성

ServeMyAPI는 모든 MCP 호환 클라이언트와 호환됩니다. 예제 구성 파일은 examples 디렉토리에 있습니다.

클로드 데스크탑

Claude Desktop에서 ServeMyAPI를 사용하려면:

1. Claude Desktop 구성 파일을 찾거나 만듭니다.
   • macOS : ~/Library/Application Support/Claude/claude_desktop_config.json
   • 윈도우 : %AppData%\Claude\claude_desktop_config.json
2. mcpServers 섹션에 ServeMyAPI를 추가합니다( examples/claude_desktop_config.json 에서 복사할 수 있음):
   { "mcpServers": { "serveMyAPI": { "command": "node", "args": [ "/ABSOLUTE/PATH/TO/servemyapi/dist/index.js" ] } } }
3. /ABSOLUTE/PATH/TO/servemyapi ServeMyAPI 설치의 실제 경로로 바꾸세요.
4. Claude Desktop을 다시 시작합니다.

윈드서핑

Windsurf에서 ServeMyAPI를 사용하려면:

1. Windsurf 편집기를 열고 설정으로 이동하세요.
2. examples/windsurf_config.json 의 예를 사용하여 MCP 서버 구성에 ServeMyAPI를 추가합니다.
3. 로컬 설치에 맞게 경로를 조정하세요

MCP 도구

ServeMyAPI는 다음과 같은 도구를 제공합니다.

스토어 API 키

API 키를 키체인에 저장합니다.

매개변수:

• name : API 키의 이름/식별자
• key : 저장할 API 키

예시(클로드):

get-api-key

키체인에서 API 키를 검색합니다.

매개변수:

• name : 검색할 API 키의 이름/식별자

예시(클로드):

삭제-api-키

키체인에서 API 키를 삭제합니다.

매개변수:

• name : 삭제할 API 키의 이름/식별자

예시(클로드):

목록-API-키

저장된 모든 API 키를 나열합니다.

매개변수가 필요하지 않습니다.

예시(클로드):

보안 참고 사항

• 모든 API 키는 macOS 키체인에 안전하게 저장됩니다.
• 키는 현재 사용자만 접근할 수 있습니다.
• 키체인에 접근하려면 인증이 필요합니다.
• 키는 일반 텍스트로 저장되지 않으며 어디에도 기록되지 않습니다.

로드맵

ServeMyAPI의 향후 계획은 다음과 같습니다.

• 코드 스캐너 도구 : 코드베이스에서 API 엔드포인트, 민감한 URL 및 환경 변수를 자동으로 스캔하여 키체인에 저장할 이름을 제안하는 도구입니다. 이를 통해 개발자는 일반 워크플로에서 .ENV 파일을 계속 사용하는 동시에 필요 시 LLM 및 기타 도구에서도 자격 증명을 사용할 수 있습니다.
• 크로스 플랫폼 지원 : ServeMyAPI를 보다 광범위하게 이용할 수 있도록 Windows 및 Linux에서 안전한 자격 증명 저장 옵션을 조사합니다.
• 인기 있는 프레임워크와의 통합 : Next.js, Express 등의 프레임워크와 쉽게 통합할 수 있습니다.
• 키 관리를 위한 UI : 저장된 API 키를 직접 관리할 수 있는 간단한 웹 인터페이스입니다.

이슈를 개설하거나 풀 리퀘스트를 통해 추가 기능을 제안하거나 로드맵에 기여하세요.

개발

특허

MIT