Phrases MCP Server

🤖 문구 MCP 서버

영감을 주는 명언을 관리하기 위한 우아하고 효율적인 MCP(모델 컨텍스트 프로토콜) 서버입니다. Claude for Desktop 및 기타 MCP 클라이언트와 완벽하게 통합되도록 설계되었습니다.

✨ 특징

• 완벽한 구문 관리 - 구문을 쉽게 만들고, 읽고, 업데이트하고, 삭제하세요
• 데스크톱 통합을 위한 Claude - Claude에서 직접 문구와 상호 작용하세요
• 통합 모의 API - 테스트 및 개발을 위해 모의 API를 사용하세요

🛠️ 사용 가능한 도구

서버는 다음과 같은 MCP 도구를 제공합니다.

🚀 설치

지엑스피1

🔌 데스크톱용 Claude 설정

1. 데스크탑용 Claude 설치(최신 버전이 있는지 확인하세요)
2. 이 MCP 서버를 사용하도록 데스크톱용 Claude를 구성하세요.다음 위치에서 구성 파일(MAC/Linux)을 엽니다.
   ~/Library/Application Support/Claude/claude_desktop_config.json
3. 서버 구성 추가:
   { "mcpServers": { "phrases": { "command": "node", "args": [ "/RUTA_ABSOLUTA_A/phrases/build/index.js" ] } } }
4. 데스크톱용 Claude를 다시 시작하세요

💡 클로드와 함께 사용하세요

구성이 완료되면 Claude for Desktop에서 직접 문구와 상호 작용할 수 있습니다.

• "사용 가능한 모든 구문을 보여주세요"
• "[저자 이름]의 인용문 찾기"
• "[이름]에 대해 [텍스트]라고 말하는 새 문장을 만듭니다."
• ID [번호]의 문구를 [새 텍스트]로 업데이트합니다.
• ID [번호]의 문구를 삭제하세요.

🧪 테스트

⚠️ 중요: 테스트 설정

테스트를 실행하기 전에 tsconfig.json 파일을 일시적으로 수정해야 합니다. compilerOptions 섹션을 다음으로 변경합니다.

참고 : MCP 서버 빌드가 제대로 작동하도록 테스트한 후에는 원래 구성으로 되돌리는 것을 잊지 마세요.

테스트를 실행하려면:

이 명령은 모의 API를 사용하여 문장을 만들고, 읽고, 업데이트하고, 삭제하는 일련의 테스트를 실행합니다.

🏗️ 프로젝트 구조

🔄 개발 워크플로

1. src/ 의 코드를 수정하세요
2. npm run build 로 컴파일
3. npm run test:requests 로 테스트해 보세요.
4. 변경 사항을 적용하려면 데스크톱용 Claude를 다시 시작하세요.

🔍 MockAPI 구성

이 프로젝트에서는 MockAPI를 백엔드로 사용하여 문구를 저장하고 관리합니다. 구성된 기본 URL은 다음과 같습니다.

자신의 MockAPI 인스턴스 설정

1. MockAPI 에 계정을 만드세요
2. 새 프로젝트를 만듭니다
3. 다음 필드를 사용하여 user 라는 리소스를 만듭니다.
   • id (숫자, 자동 생성)
   • name (문자열)
   • phrase (문자열)
4. API URL을 복사하세요
5. src/helpers/makeMockAPIRequest.ts 파일에서 BASE_URL 상수를 업데이트합니다.

📝 추가 참고 사항

• 이 서버는 모의 API를 사용하여 데이터를 저장합니다. 운영 환경에서는 실제 데이터베이스를 구현하는 것을 고려해보세요.
• 프로젝트 구조는 더 나은 유지 관리를 위해 공식 MCP 가이드라인을 따릅니다.
• Mock API를 사용하는 데 문제가 발생하면 MockAPI 무료 사용 한도를 확인하세요.

📄 라이센스

아이에스씨