AI agent가 익명 noddle draw 다이어그램 보드를 읽고, 생성 및 편집하며, 버전 기록 탐색, 댓글 추가 및 텍스트 기반 다이어그램 생성을 수행할 수 있게 합니다.
다른 이름 noddle-dev/noddle-draw, draw
- 스타
- 18
- Tools
- 9
- 다운로드, 30일
- —
- 최신 버전
- 1.0.0
- 마지막 커밋
- 2026년 10월 3일
- 라이선스
- MIT
noddle draw MCP란?
noddle draw은(는) MCP server입니다. AI agent가 익명 noddle draw 다이어그램 보드를 읽고, 생성 및 편집하며, 버전 기록 탐색, 댓글 추가 및 텍스트 기반 다이어그램 생성을 수행할 수 있게 합니다. 9개 도구를 제공합니다. 예: get_board, create_board, update_board.
프로젝트 README에서 생성된 요약
noddle draw MCP server 정보
noddle draw는 Claude Code 또는 Claude Desktop을 사용하는 개발자가 AI agent와 함께 시각적 다이어그램을 협업할 수 있도록 지원합니다. 이 server를 통해 agent는 사용자 계정이나 인증 토큰 없이도 익명 다이어그램 보드를 생성, 읽기 및 편집하며 팀원처럼 활동할 수 있습니다. 접근 권한은 12자리의 16진수 보드 ID 또는 직접적인 URL을 통해 완전히 관리됩니다.
사용자는 create_board, update_board, add_comment와 같은 도구를 사용하여 보드에서 실시간 시각적 토론에 참여할 수 있습니다. 이 server는 generate_diagram 도구를 통해 일반 텍스트나 Mermaid 텍스트로부터 다이어그램을 생성하는 기능을 지원하며, Claude, OpenAI, Gemini와 같은 제공업체의 공유 풀이나 사용자의 API key를 사용할 수 있습니다. 표준 라이브러리에 의존하므로 stdio 전송 방식을 통해 로컬에서 실행하려면 Python 3.9 이상만 필요합니다.
이 설정은 익명성과 단순성을 우선시한다는 점에서 독특합니다. 검색 가능한 중앙 보드 목록이 존재하지 않으며, 대신 agent는 사용자가 제공한 특정 보드에서만 작업합니다. 또한 버전 기록을 유지하므로 list_versions 및 get_version 도구를 사용하여 스냅샷을 탐색하거나 이전 상태로 복구할 수 있습니다.
활용 사례
- 1다이어그램 생성 자동화AI 클라이언트에 시스템 아키텍처에 대한 텍스트 설명을 시각적 보드로 변환하도록 요청하세요.
- 2실시간 팀 커뮤니케이션agent를 사용하여 다이어그램 내의 특정 요소에 알림이나 지침을 고정하세요.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
noddle draw MCP 도구 9
README에서 감지됨get_boardcreate_boardupdate_boardrename_boardlist_versionsget_versionlist_commentsadd_commentgenerate_diagram
| get_board | — | |
| create_board | — | |
| update_board | — | |
| rename_board | — | |
| list_versions | — | |
| get_version | — | |
| list_comments | — | |
| add_comment | — | |
| generate_diagram | — |
구성
NODDLE_AI_KEY비밀Optional AI provider key, sent only to NODDLE_BASE_URL per call and never stored.
NODDLE_AGENT_NAMEDisplay name on the agent's comments and version snapshots (max 40 chars).
NODDLE_AI_MODELOptional model override for generate_diagram.
NODDLE_AI_PROVIDEROptional bring-your-own-key provider for generate_diagram.
NODDLE_BASE_URLhttp(s) origin of the noddle draw instance. Set it to your own origin when self-hosting.
| 이름 | 설명 | 유형 |
|---|---|---|
| NODDLE_AI_KEY | Optional AI provider key, sent only to NODDLE_BASE_URL per call and never stored. | 비밀 |
| NODDLE_AGENT_NAME | Display name on the agent's comments and version snapshots (max 40 chars). | |
| NODDLE_AI_MODEL | Optional model override for generate_diagram. | |
| NODDLE_AI_PROVIDER | Optional bring-your-own-key provider for generate_diagram. | |
| NODDLE_BASE_URL | http(s) origin of the noddle draw instance. Set it to your own origin when self-hosting. |
자동 검사
2026년 11월 12일에 실행됨전체 보고서 →자동 검사를 통과했습니다. 이는 보안 감사가 아닙니다. 코드를 직접 읽고 서버에 필요한 최소한의 권한만 부여하십시오. 검사 방식
- 소스 저장소 연결 및 접근 가능통과
- 오픈 소스 라이선스 (OSI)통과
- 최근 1년 내 커밋 또는 릴리스통과
- 패키지 이름이 인기 패키지와 유사하지 않음검사되지 않음
- 원격 엔드포인트가 HTTPS 사용검사되지 않음
- 파괴적인 도구에 라벨 표시됨통과
- 모델에 대한 숨겨진 지침 없음통과
- 패키지 및 해당 종속성에 중요한 보안 권고 없음검사되지 않음
README
GitHub에서 보기noddle draw MCP server
Lets an AI agent (Claude Code, Claude Desktop, or any MCP client) work on a board alongside you: read, create and edit boards, browse version history, and comment like any other collaborator.
noddle draw is anonymous. There are no accounts and no tokens. A board id (12 hex
chars) or a board URL is the capability. The agent can open any board you give it, and
anyone holding the link of a board the agent creates can open it too. The agent signs its
comments and version snapshots with NODDLE_AGENT_NAME.
- Stdlib-only Python ≥ 3.9 (
urllib+json), so there is nothing to install. - stdio transport: one JSON-RPC 2.0 message per line. stdout carries only protocol messages, and logs go to stderr.
- MCP protocol, dual-era:
- 2026-07-28 (modern, stateless): every request carries
_meta["io.modelcontextprotocol/protocolVersion"]+clientCapabilities. The server implementsserver/discover, and setsresultTypeand_meta["io.modelcontextprotocol/serverInfo"]on every result, plusttlMs/cacheScopeon list/read results. An unsupported version returns-32022 UnsupportedProtocolVersion. - Legacy
initializehandshake: 2025-11-25, 2025-06-18, 2025-03-26, 2024-11-05. The server answers with the client's version when it supports it, and otherwise with 2025-11-25.pingworks in this mode. JSON-RPC batches are accepted only for 2025-03-26, the only revision that allowed them.
- 2026-07-28 (modern, stateless): every request carries
1. Register
Claude Code (from the repo root; an absolute script path is more robust):
claude mcp add noddle -- python3 mcp/noddle_mcp.py
# a self-hosted instance instead of draw.noddle.dev:
claude mcp add noddle --env NODDLE_BASE_URL=http://127.0.0.1:8000 -- python3 mcp/noddle_mcp.py
Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json)
or a project .mcp.json use the same shape:
{
"mcpServers": {
"noddle": {
"command": "python3",
"args": ["/absolute/path/to/noddle-draw/mcp/noddle_mcp.py"],
"env": { "NODDLE_BASE_URL": "https://draw.noddle.dev" }
}
}
}
MCP Bundle (one-click install in Claude Desktop and other MCPB clients): download
noddle-draw.mcpb from the latest mcpb-v* release
and open it. It needs only Python 3.10+ (standard library, no install step).
From a checkout (pyproject.toml here):
uvx --from ./mcp noddle-draw-mcp # or: pipx install ./mcp && noddle-draw-mcp
The server is listed in the official MCP Registry
as dev.noddle/draw (see Releasing).
| Env | Default | |
|---|---|---|
NODDLE_BASE_URL |
https://draw.noddle.dev |
http(s) origin of the noddle draw instance. A non-http(s) value exits with code 2 |
NODDLE_AGENT_NAME |
MCP agent |
display name on comments and version history (max 40 chars) |
NODDLE_TIMEOUT |
30 |
seconds per board API call |
NODDLE_AI_TIMEOUT |
180 |
seconds for generate_diagram |
NODDLE_AI_PROVIDER |
— | optional BYOK for generate_diagram: claude, openai, gemini, openrouter or custom |
NODDLE_AI_KEY |
— | your AI provider key. It is sent only to NODDLE_BASE_URL, as the same X-AI-* headers the web app uses, and never stored. Unset means the instance's shared pool is used, if it has one |
NODDLE_AI_MODEL |
— | optional model override |
NODDLE_AI_BASE |
— | OpenAI-compatible base URL (provider custom only) |
CLI: --help, --version, --list-tools (prints the tool definitions as JSON).
Exit codes: 0 when stdin closes (normal shutdown), 2 for bad configuration.
2. Tools
Every tool returns structuredContent that conforms to its outputSchema, plus the same
JSON as a text block. Board tools also return a resource_link to noddle://board/{id}
(revisions ≥ 2025-06-18). Wherever a tool takes doc_id, you can pass either the 12-hex
id or the board URL ({base}/d/{id} or /embed/{id}). A URL on a different origin than
NODDLE_BASE_URL is refused.
| Tool | readOnly | destructive | idempotent | openWorld | What it does |
|---|---|---|---|---|---|
get_board |
✓ | ✗ | Name, url, my_role (editor/viewer), updated_at, page summary and diagram JSON. Optional page_id and include_svg |
||
create_board |
✗ | ✗ | ✗ | ✗ | New board, with optional diagram JSON. Anyone with its url can edit it |
update_board |
✗ | ✓ | ✓ | ✗ | Replace the WHOLE diagram (fetch → edit → send back). A version snapshot is kept. expected_updated_at turns a concurrent edit into a conflict error instead of an overwrite |
rename_board |
✗ | ✗ | ✓ | ✗ | Rename |
list_versions |
✓ | ✗ | Version-history snapshots, newest first | ||
get_version |
✓ | ✗ | One snapshot's diagram. To restore it, pass it to update_board |
||
list_comments |
✓ | ✗ | Comment threads | ||
add_comment |
✗ | ✗ | ✗ | ✗ | Pin to ONE of node_id / edge_id / parent_id (reply) / point x,y (+ page_id). Works on view-only links too |
generate_diagram |
✓ | ✓ | Turns prose or Mermaid into diagram JSON through the instance's AI (your BYOK key or its shared pool). It saves nothing, so pass the result to create_board/update_board |
There is deliberately no list_boards and no delete: the API has neither. Link access
is not discovery, and an anonymous board has no owner who could be trusted to delete it.
Writes to a board whose link is view-only fail with a 403 tool error.
Diagram payloads are pass-through. The server checks only the envelope
({pages:[{id,nodes,edges}]} or legacy {nodes,edges}, with string ids). Node and edge
fields are forwarded untouched, so new editor fields (e.g. the freedraw kind with
points, or curved routing) work without a server update. See DiagramNode /
DiagramEdge in contracts/openapi.yaml.
Errors:
- Bad arguments, API failures (400/403/404/413/422/429/503) and conflicts come back as
isError: truetool results that the model can act on. - Protocol errors use standard JSON-RPC codes: unknown tool or invalid params
-32602, unknown method-32601, malformed JSON-32700, invalid request-32600.
3. Resources & prompts
- Resources:
resources/listlists the boards this session has created, read or edited, asnoddle://board/{id}(application/json,lastModified). It starts empty, because the API has no listing.resources/templates/listexposesnoddle://board/{doc_id}, so a client can read any board by id.resources/readreturns the same JSON asget_board. An unknown board returns-32602. - Prompts:
design_board(topic, notes?): generate → sanity-check →create_board→ reply with the url.review_board(doc_id): embeds the board as a resource and asks for a critique posted as anchored comments.
4. Example (Claude Code)
> Create a board "Payment flow" with Client → API Gateway → Payment Service → Database,
then comment on the Database node reminding the team to review indexes.
Claude: generate_diagram(text="Client -> API Gateway -> Payment Service -> Database")
→ create_board(name="Payment flow", diagram=…)
→ add_comment(doc_id, body="Please review indexes for the payments table", node_id="db")
→ returns https://draw.noddle.dev/d/{id}
Comments reach an open board in realtime. A diagram written with update_board shows up
when the board is reloaded.
5. Tests
python3 -m pytest mcp -q # or: python3 -m unittest discover mcp
test_noddle_mcp.py runs the real server over stdio against a fake in-process REST
backend. It covers version negotiation (modern and legacy), schema validity, read and
write tools, board-URL ids, view-only links, resources, prompts, BYOK header forwarding
and error paths. It also asserts that stdout carries only JSON-RPC, that no request ever
carries an Authorization header, and that a BYOK key never leaks into output or logs.
Releasing
mcp/server.json is the registry listing (dev.noddle/draw); it points at the MCP Bundle
attached to a GitHub release. The dev.noddle/* namespace is verified over HTTP: noddle.dev
serves the publisher's ed25519 public key at /.well-known/mcp-registry-auth.
- Bump the version everywhere, all equal:
__version__innoddle_mcp.py,versioninmcpb/manifest.json,versioninpyproject.toml, andversioninserver.json. Registry versions are immutable; a metadata-only fix uses a suffix such as1.0.0-1. - Build the bundle:
mcp/build_mcpb.sh→mcp/dist/noddle-draw.mcpb(prints its SHA-256). - Create the release with that exact file:
gh release create mcpb-v<version> mcp/dist/noddle-draw.mcpb --title "MCP server <version>". - In
server.json, set the packageidentifierto the release download URL andfileSha256to the printed hash, then publish with the namespace key holder'smcp-publisher login http --domain noddle.dev --private-key …andmcp-publisher publish mcp/server.json.
Notes
update_boardkeeps the stored SVG preview. The preview refreshes on the next save in the editor.- Cross-origin HTTP redirects are refused, so a BYOK key is never forwarded to another
host. A BYOK key over plain
httpto a non-loopback host logs a warning. generate_diagramsends text to an AI provider. Never pass customer PII, credentials or account numbers.
noddle draw MCP 질문
noddle draw MCP는 어떤 도구를 제공하나요?
9개 도구를 제공합니다. 예: get_board, create_board, update_board, rename_board, list_versions.
noddle draw MCP server를 사용하려면 API key나 계정이 필요한가요?
아니요. noddle draw는 익명으로 운영되므로 계정이나 토큰이 필요하지 않습니다. 보드 ID 또는 보드 URL이 보드를 열고 편집할 수 있는 권한 역할을 합니다.
MCP server가 제 보드 목록을 조회하거나 삭제할 수 있나요?
아니요. API에서 지원하지 않으므로 list_boards나 delete 도구는 존재하지 않습니다. 링크를 통한 접근은 검색(discovery) 방식이 아닙니다.
Claude Code에 noddle draw MCP server를 어떻게 설치하나요?
레포지토리 루트에서 claude mcp add noddle -- python3 mcp/noddle_mcp.py를 실행하세요. 셀프 호스팅 인스턴스를 사용하는 경우 선택적으로 NODDLE_BASE_URL을 설정할 수 있습니다.
서버가 텍스트 프롬프트로 다이어그램을 생성할 수 있나요?
네. generate_diagram 도구를 통해 일반 텍스트나 Mermaid를 인스턴스의 AI를 사용하여 다이어그램 JSON으로 변환합니다. 이때 본인의 API key를 사용하거나 공유 풀을 사용할 수 있지만, 결과물을 저장하지는 않으므로 생성된 결과를 create_board 또는 update_board에 전달해야 합니다.
보드를 업데이트할 때 다른 사람의 동시 편집 내용을 덮어쓰지 않으려면 어떻게 하나요?
update_board 호출 시 expected_updated_at을 전달하면, 동시 편집 발생 시 덮어쓰는 대신 충돌 에러를 반환합니다. 또한 각 업데이트는 버전 스냅샷을 유지합니다.