Json Markdown Studio

로컬 JSON & Markdown 데스크톱 에디터 — A local desktop editor for JSON & Markdown

내장 MCP Server — 모든 AI 에이전트(Claude Code / Codex / Cursor)가 에디터에 직접 연결하여 파일을 안전하게 읽고 쓸 수 있습니다. 권한 등급, 로컬 전용, 업로드 없음. Built-in MCP server — let AI agents read & edit your files directly through a gated, permission-scoped interface. 100% local.

Windows · Tauri v2 · React 19 · TypeScript · Vite ·

Json Markdown Studio는 로컬 파일을 위한 데스크톱 에디터입니다. JSON은 트리 뷰 / 테이블 뷰 / 실시간 구문 검증을 지원하고, Markdown은 WYSIWYG(위지위그) 편집을 제공하며, 외부 AI 에이전트(Codex / Claude Code / Cursor)가 문서를 직접 조작할 수 있도록 MCP Server가 내장되어 있습니다.

A lightweight desktop editor for local JSON & Markdown files — tree/table views, live JSON validation, WYSIWYG Markdown editing, plus a built-in MCP server so external AI agents can drive the editor directly.

✨ Features 기능

• JSON — 트리 뷰 / 테이블 뷰 / 코드 뷰, 실시간 구문 검증 및 오류 위치 표시, 경로 통계 Tree / table / code views, live syntax validation with precise error location, path statistics

• Markdown — WYSIWYG 편집: 렌더링된 블록을 클릭하여 바로 수정, 서식이 실시간으로 적용됨; 플로팅 서식 도구 모음 True WYSIWYG editing — click any rendered block and type, formatting applies live; floating format toolbar

• AI 연동 (MCP Server) — 제어된 화이트리스트 인터페이스: 외부 AI 에이전트가 파일 읽기/쓰기, 검색, JSON 경로 수정, 마크다운 섹션 추가 가능 — 읽기 전용 / 쓰기 전 확인 / 전체 허용 3단계 권한 Gated whitelist interface: external AI agents can read/write files, search, patch JSON by path, append markdown sections — read-only / confirm-before-write / full-access modes

• 가벼운 데스크톱 경험 — 프레임리스 커스텀 타이틀 바, 완전 로컬 실행, 네트워크 불필요 Frameless custom title bar, fully local, no cloud dependency

Related MCP server: LocalNest MCP

📦 설치 Installation

GitHub Releases에서 다운로드 (권장)

최신 설치 패키지가 Releases 페이지에 업로드되어 있습니다. 필요에 따라 선택하세요:

Download the latest installer from the Releases page — NSIS setup for regular use, MSI for enterprise deployment, or a portable exe that runs without installation.

소스에서 빌드 From Source

Prerequisites: Node.js ≥ 20, Rust（MSVC toolchain, see rustup）

npm install          # 安装依赖 install dependencies
npm run tauri dev    # 桌面开发模式 desktop dev mode (runs Vite + Rust backend)
npm run tauri build  # 构建安装包 build installers (NSIS + MSI)

프론트엔드 단독 개발: npm run dev (Vite 기본 3000 포트).

🧩 MCP Server（AI 에이전트 연동）

설정 → 외부 AI 에이전트 연동 (MCP Server) 에서 접근 모드(읽기 전용 / 쓰기 확인 / 전체 허용)를 선택하면 서비스가 시작됩니다:

• 수신 주소: http://127.0.0.1:<random-port>/mcp

• 포트 발견 파일: %APPDATA%\com.jsonmarkdownstudio.app\mcp.port

# 示例：Claude Code / Codex 等 MCP 客户端配置
{
  "mcpServers": {
    "json-md-studio": {
      "url": "http://127.0.0.1:<port>/mcp"
    }
  }
}

내장 도구 예시: app.getState(앱 상태), file.read/setContent/replace/insert/delete(파일 읽기/쓰기/편집), search.run(검색), json.validate(JSON 검증), document.updateValueByPath(JSON 경로로 값 수정), view.setMode(뷰 전환).

🗂 기술 스택 Tech Stack

🤝 기여 Contributing

Issue와 Pull Request를 환영합니다. 주요 디렉터리: src/(프론트엔드), src-tauri/(Rust 백엔드, src-tauri/src/mcp/는 MCP Server 구현).

Issues and PRs are welcome. Core code lives in src/ (frontend) and src-tauri/ (Rust backend, with src-tauri/src/mcp/ for the MCP server).

📄 라이선스 License

MIT