AI 니케짱 지식 검색 MCP 서버

비공식 도구입니다. 이 프로젝트는 AI 니케짱, 그 운영자, X, OpenAI 또는 관련 각 사·단체로부터 승인, 제휴, 후원을 받은 것이 아닙니다. 명칭·게시물·웹사이트 등의 정보원에 관한 권리는 각각의 권리자에게 귀속됩니다.

AI 니케짱에 관한 공개 정보를 MCP(Model Context Protocol) 클라이언트에서 검색하기 위한 Next.js / Vercel용 서버입니다. 질문은 Vercel AI Gateway를 통해 OpenAI Embeddings로 벡터화되며, 검색 결과에는 정보원 URL과 게시 일시를 포함합니다.

공개 리포지토리에 포함하지 않는 것

이 리포지토리에는 다음을 절대 커밋하지 않습니다.

• X 게시물 수집 데이터와 그 파생 텍스트

• 게시물 본문을 포함하는 검색 메타데이터와 생성된 벡터

• .env 계열 환경 변수 파일, API 키, 인증 토큰

이들은 .gitignore와 .vercelignore에서 제외되어 있습니다. 공개 배포에서는 생성된 인덱스를 Private Vercel Blob에서 읽어오므로, 게시물 데이터를 리포지토리나 Function의 배포물에 포함하지 않습니다.

데모 공개와 보안

이 프로젝트는 단기 공개 데모를 위해 MCP 엔드포인트를 인증 없이 공개합니다. Vercel에는 AI_GATEWAY_API_KEY와 Private Blob을 연결하여 추가되는 스토리지용 설정을 등록합니다. 값을 GitHub, 클라이언트 코드, 로그에 저장하지 마세요.

AI_GATEWAY_API_KEY=
BLOB_READ_WRITE_TOKEN=

제3자도 검색을 실행할 수 있으므로 AI Gateway 이용 요금이 발생합니다. 공개 기간을 짧게 하고, Vercel 측 WAF와 레이트 제한을 설정한 뒤 이용 상황을 확인하세요. 데모 종료 후에는 배포를 중지하세요.

이 작업 폴더의 .env에서 인증 정보로 보이는 값이 감지되었습니다. Git에 추가하기 전에 현재 사용 중이 아닌지 확인하고, 필요하다면 키를 로테이션하세요.

로컬 개발

npm install
cp .env.example .env.local
# .env.local に OPENAI_API_KEY を設定
npm run build:index
npm run dev

로컬 검색 엔드포인트는 http://localhost:3000/api/mcp입니다. 인덱스 생성에는 제외된 X 게시물 데이터가 로컬에 필요합니다.

Vercel Blob에 인덱스 배치

1. Vercel 프로젝트의 Storage에서 Private 액세스의 Blob 스토어를 생성하여 프로젝트에 연결합니다.

2. Vercel의 환경 변수를 로컬로 가져와 로컬 .env.local에 BLOB_READ_WRITE_TOKEN을 설정합니다.

3. 로컬에서 인덱스를 생성한 후 다음을 실행합니다.

npm run upload:index

indexes/metadata.json과 indexes/embeddings.f32가 Private Blob에 업로드됩니다. Vercel 환경에서는 이 두 개를 읽어오고, 로컬 환경에서는 종래대로 src/data의 파일을 읽어옵니다. Blob 내 경로를 변경하는 경우에만 VECTOR_INDEX_METADATA_PATH와 VECTOR_INDEX_VECTORS_PATH를 로컬과 Vercel 양쪽에 같은 값으로 설정하세요.

MCP 도구

• search_nikechan_knowledge: X 게시물과 공식 사이트를 횡단한 의미 검색

• search_x_posts: X 게시물만의 의미 검색

• search_hybrid: 키워드 일치와 의미 검색을 결합한 검색

• search_keywords: 키워드 검색

• search_timeline: 기간·연월에 의한 검색

• get_popular_posts: 반응 수순 검색

• get_x_post / get_x_thread: 게시물 또는 스레드 취득

• x_posts_dataset_info: 인덱스의 건수와 구성 확인

결과는 공개 정보를 바탕으로 한 참고 정보입니다. 정확성, 완전성, 최신성은 보장되지 않으므로, 답변에서는 반환된 URL의 원전을 확인하세요.

검증

npm run lint
npm test
npm run build

알려진 배포 전 확인 사항

의존성 감사에서는 Next.js 계열의 고중요도 취약점이 남아 있습니다. 수정에는 Next.js 16으로의 파괴적 변경이 수반되므로, 이 리포지토리에서는 자동 업데이트하지 않습니다. Vercel 본배포 전에 호환성을 확인한 뒤 Next.js를 업데이트하고, 다시 npm audit --omit=dev --audit-level=high를 실행하세요.