Home
Login
worldnine/scrapbox-cosense-mcpPlease refer to the latest official releases for information GitHub Homepage

Scrapbox/Cosense 플랫폼을 위해 설계된 MCP 서버로, 페이지 검색, 검색 및 생성 기능을 지원합니다.

MITTypeScript 24worldninescrapbox-cosense-mcp Last Updated: 2025-06-15

Scrapbox Cosense MCP 서버 프로젝트 소개

프로젝트 개요

scrapbox-cosense-mcp는 cosense/scrapbox 플랫폼을 위해 특별히 설계된 MCP(Model Context Protocol) 서버입니다. 이 프로젝트는 worldnine에서 개발했으며 GitHub에 호스팅되어 AI 애플리케이션에 Scrapbox 지식 베이스와의 표준화된 인터페이스를 제공하는 것을 목표로 합니다.

Scrapbox/Cosense란 무엇인가?

Cosense는 "생산성의 핵심은 지식에 있다"는 핵심 이념을 가진 지식 관리 플랫폼입니다. 사용자가 경험을 공유하고 지식을 축적하며 조직 내에서 지식의 복합적인 성장을 쉽게 실현할 수 있도록 합니다.

핵심 기능

1. get_page (페이지 가져오기)

  • 기능 설명: cosense/Scrapbox에서 페이지 내용 가져오기
  • 입력 매개변수: 페이지 제목
  • 출력 내용: 페이지 내용, 메타데이터, 링크 정보 및 편집자 정보

2. list_pages (페이지 목록 나열)

  • 기능 설명: 프로젝트 내의 페이지 목록 가져오기
  • 제한 조건: 최대 1000개의 페이지 반환
  • 출력 내용: 프로젝트 내 모든 페이지의 제목 목록

3. search_pages (페이지 검색)

  • 기능 설명: 프로젝트 내에서 전체 텍스트 검색 수행
  • 검색 능력: 기본 검색, AND 검색, OR 검색 및 NOT 검색 지원
  • 제한 조건: 최대 100개의 검색 결과 반환
  • 출력 내용: 검색 조건에 맞는 페이지 제목 목록

4. create_pages (페이지 생성)

  • 기능 설명: 페이지 URL 생성
  • 입력 매개변수: 페이지 제목 및 선택적 본문 내용
  • 출력 내용: 브라우저에서 열 수 있는 URL

설치 및 구성

로컬 개발 설치

# 프로젝트 복제
git clone https://github.com/worldnine/scrapbox-cosense-mcp.git
cd scrapbox-cosense-mcp

# 의존성 설치
npm install

# 서버 빌드
npm run build

# 개발 시 자동 재빌드
npm run watch

Claude Desktop 통합 구성

Claude Desktop에서 이 서버를 사용하려면 구성 파일에 서버 설정을 추가해야 합니다.

macOS 구성 파일 경로:

~/Library/Application\ Support/Claude/claude_desktop_config.json

Windows 구성 파일 경로:

%APPDATA%/Claude/claude_desktop_config.json

구성 예시:

{
  "mcpServers": {
    "scrapbox-cosense-mcp": {
      "command": "npx",
      "args": ["github:worldnine/scrapbox-cosense-mcp"],
      "env": {
        "COSENSE_PROJECT_NAME": "your_project_name",
        "COSENSE_SID": "your_sid",
        "COSENSE_PAGE_LIMIT": "25",
        "COSENSE_SORT_METHOD": "created",
        "SERVICE_LABEL": "scrapbox(cosense)"
      }
    }
  }
}

환경 변수 설명

필수 변수

  • COSENSE_PROJECT_NAME: 프로젝트 이름 (필수)
    • 설정되지 않은 경우 서버 시작 시 오류 발생 후 종료

선택적 변수

  • COSENSE_SID: Scrapbox/Cosense 인증 세션 ID

    • 비공개 프로젝트 액세스 시 필수
    • 설정되지 않은 경우 공개 프로젝트만 액세스 가능

  • API_DOMAIN: API 도메인 (기본값: "scrapbox.io")

    • "cosen.se"를 사용해야 할 수 있는 특정 환경에 대한 옵션 제공

  • SERVICE_LABEL: 서비스 식별자 (기본값: "cosense (scrapbox)")

  • COSENSE_PAGE_LIMIT: 초기 페이지 가져오기 제한 (기본값: 100)

    • 유효 범위: 1-1000
    • 범위를 벗어날 경우 자동으로 기본값 사용

  • COSENSE_SORT_METHOD: 초기 페이지 가져오기 순서 (기본값: "updated")

    • 선택 가능한 값: updated/created/accessed/linked/views/title
    • 초기 리소스 가져오기에만 영향을 미치며 list_pages 도구에는 영향을 미치지 않음

디버깅 도구

MCP 서버는 stdio를 통해 통신하므로 디버깅이 어려울 수 있습니다. 프로젝트에서는 MCP Inspector를 사용하여 디버깅하는 것을 권장합니다.

npm run inspector

Inspector는 브라우저에서 디버깅 도구에 액세스할 수 있는 URL을 제공합니다.

프로젝트 특징

  1. 표준화된 인터페이스: 이 서버는 cosense/Scrapbox 프로젝트와의 상호 작용을 촉진하여 사용자가 페이지를 검색, 나열, 검색 및 생성할 수 있도록 하며 다양한 쿼리 작업과 비공개 프로젝트에 대한 안전한 액세스를 지원합니다.

  2. 보안성: 세션 ID를 통해 비공개 프로젝트에 액세스할 수 있도록 지원하여 데이터 보안을 보장합니다.

  3. 유연한 구성: 다양한 환경 변수 옵션을 제공하여 다양한 사용 시나리오에 적응할 수 있습니다.

  4. 개발 친화적: 개발 모드에서 자동 재빌드 및 전용 디버깅 도구를 제공합니다.

사용 시나리오

  • 지식 관리 자동화: Scrapbox를 통합하여 지식 관리, 협업 노트 및 챗봇 애플리케이션의 페이지 읽기/쓰기 기능 구현
  • AI 도우미 강화: AI 애플리케이션에 구조화된 지식 베이스에 액세스할 수 있는 기능 제공
  • 콘텐츠 검색 최적화: 표준화된 API를 통해 Scrapbox 콘텐츠를 효율적으로 검색하고 검색
  • 협업 도구 통합: Scrapbox의 협업 기능을 다른 AI 도구에 통합

기술 아키텍처

이 프로젝트는 Model Context Protocol 아키텍처를 기반으로 하며 개발자는 MCP 서버를 통해 데이터를 노출하거나 AI 애플리케이션(MCP 클라이언트)을 구축할 수 있습니다. 이 프로젝트는 Node.js 및 TypeScript를 사용하여 개발되었으며 MCP 표준 프로토콜 사양을 준수합니다.

요약

scrapbox-cosense-mcp는 AI 애플리케이션에 Scrapbox 지식 베이스와 상호 작용할 수 있는 표준화된 방법을 제공하는 완전한 기능을 갖춘 MCP 서버 구현입니다. 기본적인 페이지 작업뿐만 아니라 강력한 검색 기능과 안전한 비공개 프로젝트 액세스 기능을 제공하여 지능형 지식 관리 시스템을 구축하는 데 이상적인 도구입니다.

Star History Chart