vibetutor-mcp

vibetutor-mcp

Personal AI tutor MCP that automatically generates structured coding practice materials based on coding context and local files.

Category
Visit Server

README

vibetutor-mcp

개인 AI튜터 MCP: 코딩 컨텍스트와 로컬 파일을 기반으로 구조화된 실습 교재를 자동 생성

아키텍처

Clean Architecture (Presentation → Domain ← Data). 자세한 규칙은 AGENTS.md, 코드 패턴은 SKILLS.md, 교재 디자인은 DESIGN.md 를 참조한다.

src/vibetutor_mcp/
  presentation/   @mcp.prompt / @mcp.tool (얇은 어댑터)
  domain/         model / repository / ports / usecase (순수 Python)
  data/           SQLAlchemy / Jinja2 / WeasyPrint / 파일시스템 구현체
  core/           config, exceptions
  main.py         FastMCP 엔트리포인트 (Composition Root)
templates/        교재 Jinja2 템플릿 + styles + fonts (Pretendard 임베딩)
tests/            pytest

개발 (uv)

uv sync                       # 의존성 설치 (.venv 생성)
uv run mypy src               # 타입 검사 (strict)
uv run ruff check             # 린트
uv run black --check src tests
uv run pytest                 # 테스트

실행

uv run vibetutor-mcp          # MCP 서버 (stdio)

Docker

WeasyPrint 네이티브 의존성(Pango/cairo/GDK-PixBuf)을 컨테이너 경계에 고정한다.

docker build -t vibetutor-mcp .

라이선스

이 프로젝트의 소스 코드는 MIT License 를 따른다. (루트 LICENSE 참고)

서드파티 폰트

templates/fonts/ 의 Pretendard 글꼴은 SIL Open Font License 1.1 로 배포되며, PDF 교재의 한글 임베딩 폰트로 동봉된다.

  • Pretendard © 2021 Kil Hyung-jin — https://github.com/orioncactus/pretendard
  • Reserved Font Name: "Pretendard"
  • 라이선스 전문: templates/fonts/LICENSE.txt

Recommended Servers

playwright-mcp

playwright-mcp

A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.

Official
Featured
TypeScript
Magic Component Platform (MCP)

Magic Component Platform (MCP)

An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.

Official
Featured
Local
TypeScript
Audiense Insights MCP Server

Audiense Insights MCP Server

Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.

Official
Featured
Local
TypeScript
VeyraX MCP

VeyraX MCP

Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.

Official
Featured
Local
graphlit-mcp-server

graphlit-mcp-server

The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.

Official
Featured
TypeScript
Kagi MCP Server

Kagi MCP Server

An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.

Official
Featured
Python
E2B

E2B

Using MCP to run code via e2b.

Official
Featured
Neon Database

Neon Database

MCP server for interacting with Neon Management API and databases

Official
Featured
Exa Search

Exa Search

A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.

Official
Featured
Qdrant Server

Qdrant Server

This repository is an example of how to create a MCP server for Qdrant, a vector search engine.

Official
Featured