🤖 문구 MCP 서버

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

✨ 특징

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

🛠️ 사용 가능한 도구

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

도구	설명
`get-all-phrases`	사용 가능한 모든 구문을 가져옵니다
`get-phrase-by-id`	ID로 구문 검색
`get-phrase-by-name`	작성자 이름으로 문구 검색
`create-phrase`	새로운 문장을 만들어 보세요
`update-phrase`	기존 문장의 텍스트를 업데이트합니다
`delete-phrase`	ID로 구문 삭제

🚀 설치

지엑스피1

🔌 데스크톱용 Claude 설정

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

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

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

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

🧪 테스트

⚠️ 중요: 테스트 설정

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

"compilerOptions": {
  "target": "ES2020",
  "module": "NodeNext",
  "moduleResolution": "NodeNext",
  "esModuleInterop": true,
  "outDir": "build",
  "strict": true
}

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

테스트를 실행하려면:

npm run test:requests

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

🏗️ 프로젝트 구조

src/
├── helpers/
│   └── makeMockAPIRequest.ts  # Funciones de ayuda para interactuar con la API
├── index.ts                   # Punto de entrada principal y definición de herramientas
└── testRequest.ts             # Script para probar las funciones de la API

🔄 개발 워크플로

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

🔍 MockAPI 구성

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

https://67ec86aeaa794fb3222e0682.mockapi.io/frases/api/v1/user

자신의 MockAPI 인스턴스 설정

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

// Cambia esta línea con tu propia URL de MockAPI
const BASE_URL = "https://tu-proyecto.mockapi.io/tu-path/user";

📝 추가 참고 사항

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

📄 라이센스

아이에스씨

Phrases MCP Server