Yonote MCP 서버 프로토타입

이는 Notion의 대안인 Yonote 서비스를 위한 MCP 서버의 MVP 프로젝트입니다. 이 서버는 Yonote 문서 및 컬렉션과 상호 작용할 수 있는 API 도구를 제공합니다.

특징

• Yonote의 문서 및 컬렉션 목록

• 문서에 대한 자세한 정보를 얻으세요

• FastMCP 프레임워크를 통해 도구를 노출합니다.

Related MCP server: mcp-discord-chat MCP server

요구 사항

• 파이썬 3.13+

• Yonote API 자격 증명

• 다음은 Python 패키지입니다( pyproject.toml 참조):

  • fast-agent-mcp>=0.2.23

  • requests>=2.32.3

  • python-dotenv (환경 변수 로딩용)

• 종속성 관리를 위한 uv

설정

Smithery를 통해 설치

Smithery를 통해 Claude Desktop용 Yonote Document Interaction Server를 자동으로 설치하려면:

지엑스피1

수동 설치

1. 저장소를 복제합니다.

   git clone <your-repo-url> cd yonote-mcp

2. uv를 사용하여 종속성을 설치합니다.

   uv pip install -r requirements.txt # or, using pyproject.toml: uv pip install .

3. 환경 변수 구성:

   프로젝트 루트에 다음 내용으로 .env 파일을 만듭니다.

   API_TOKEN=your_yonote_api_token API_BASE_URL=https://app.yonote.ru/api # Optional, defaults to this value

용법

MCP 서버를 실행합니다.

서버는 다음 도구를 제공합니다.

• documents_list : 문서 목록을 가져옵니다(선택적으로 limit, offset, collectionId 사용)

• documents_info : ID로 문서에 대한 정보를 가져옵니다.

• collections_list : 컬렉션 목록을 가져옵니다(선택적으로 limit 및 offset 사용)

프로젝트 구조

• main.py — 메인 서버 코드 및 도구 정의

• pyproject.toml — 프로젝트 메타데이터 및 종속성

특허

MIT(또는 라이센스를 명시하세요)

커서 구성 예

이 MCP 서버를 Cursor와 함께 사용하려면 ~/.cursor/mcp.json 구성 파일에 다음을 추가하세요.

/path/to/yonote-mcp 프로젝트 디렉토리의 실제 경로로 바꾸세요.