MCP 服务器

jobs-tools-knowledgebase

A MongoDB Atlas-based Notion-style knowledge base management MCP server that supports user workspaces, project management, page CRUD with tree structure, and text search.

README

Jobs-tools-knowledgeBase

MongoDB Atlas 기반 Notion 스타일 지식베이스 관리 MCP(Model Context Protocol) 도구입니다.

🎯 기능

사용자 워크스페이스 격리: 고유 키로 데이터 분리 보안
프로젝트 관리: 여러 프로젝트 생성 및 관리
페이지 CRUD: 마크다운 형식의 페이지 생성/수정/삭제
트리 구조: Notion처럼 부모-자식 계층 구조 지원
검색 기능: 제목과 본문에서 텍스트 검색
MongoDB Atlas 무료 티어: 클라우드 기반, 무료로 사용 가능

📦 설치 및 설정

1단계: MongoDB Atlas 설정

MongoDB Atlas 무료 계정 생성
무료 클러스터 생성 (M0 Sandbox)
Database User 생성
Network Access에서 현재 IP 추가 (또는 0.0.0.0/0 모든 IP 허용)

연결 문자열 복사:

mongodb+srv://<username>:<password>@<cluster>.mongodb.net/?retryWrites=true&w=majority

2단계: 환경 변수 설정

프로젝트 루트에 .env 파일 생성:

# User Key (처음에는 비워둠 - 도구가 생성해줍니다)
JOBS_TOOLS_USER_KEY=

# MongoDB Atlas 연결 정보
MONGODB_URI=mongodb+srv://<username>:<password>@<cluster>.mongodb.net/?retryWrites=true&w=majority
MONGODB_DB=jobs_tools_knowledge

3단계: MCP 설정 파일에 추가

사용 중인 MCP 클라이언트의 설정 파일 또는 프로젝트 루트 mcp.json에 다음을 추가하세요:

macOS (예시): ~/Library/Application Support/YourClient/config.json

{
  "mcpServers": {
    "knowledgeBase": {
      "command": "npx",
      "args": ["-y", "jobs-tools-knowledgebase"],
      "env": {
        "JOBS_TOOLS_USER_KEY": "",
        "MONGODB_URI": "mongodb+srv://...",
        "MONGODB_DB": "jobs_tools_knowledge"
      }
    }
  }
}

Windows (예시): %APPDATA%\\YourClient\\config.json

{
  "mcpServers": {
    "knowledgeBase": {
      "command": "npx.cmd",
      "args": ["-y", "jobs-tools-knowledgebase"],
      "env": {
        "JOBS_TOOLS_USER_KEY": "",
        "MONGODB_URI": "mongodb+srv://...",
        "MONGODB_DB": "jobs_tools_knowledge"
      }
    }
  }
}

4단계: 초기 설정

MCP 클라이언트에서 아래 문구로 초기화하세요:

업무 세팅하자

→ 사용자 키 생성 → 환경 변수에 저장 → 클라이언트 재시작

업무 시작하자

→ MongoDB 연결 확인 → 프로젝트 및 페이지 사용 시작!

처음 실행 시 자동 응답 예시 (env에 키가 없을 때)

처음 채팅을 시작하면 MCP가 JOBS_TOOLS_USER_KEY 여부를 확인합니다. 없으면 아래 형식으로 키와 안내 메시지를 반환합니다:

{
  "userKey": "random-0ser-id",
  "message": "새 사용자 키를 발급했습니다. MCP 설정(env)의 JOBS_TOOLS_USER_KEY에 저장한 뒤, 클라이언트를 재시작하고 다시 대화를 시작해주세요."
}

OS별 env 저장 위치는 위의 MCP 설정 파일 예시(macOS/Windows)를 참고하세요. 재시작 후에는 키가 자동 인식되며, 이어서 MongoDB 연결 점검과 프로젝트 작업을 진행합니다.

🚀 사용법

초기 설정

업무 세팅하자

도구가 사용자 키를 생성하고 반환합니다. 이 키를 MCP 설정의 JOBS_TOOLS_USER_KEY에 저장하세요.

MongoDB 연결 확인

MongoDB 연결 상태 확인해줘

프로젝트 생성

"개인 노트" 프로젝트 만들어줘

프로젝트 목록 조회

내 프로젝트 목록 보여줘

페이지 생성

"개인 노트" 프로젝트에 "회의록" 페이지 만들어줘
내용: # 2025-01-15 팀 미팅
- 참석자: A, B, C
- 안건: 프로젝트 계획

페이지 조회

프로젝트 [projectId]의 페이지 [pageId] 내용 보여줘

트리 구조 조회

"개인 노트" 프로젝트의 페이지 구조 보여줘

페이지 이동

페이지 [pageId]를 부모 [parentId] 아래로 이동해줘

페이지 검색

"개인 노트" 프로젝트에서 "회의록" 검색해줘

📋 API