openclaw-molt-mcp

Name: clawd-mcp
Author: sandraschi

FastMCP Version Ruff Linted with Biome Built with Just

Status OpenClaw FastMCP Python License: MIT

MCP 서버 + 웹앱으로, Cursor와 Claude Desktop을 OpenClaw 및 Moltbook에 연결합니다. openclaw-molt-mcp는 해당 플랫폼(게이트웨이, API)을 사용하며, 이를 구현하거나 대체하지 않습니다. 알파 버전입니다. LLM용 수집: gitingest.com/sandraschi/openclaw-molt-mcp.

이 저장소의 역할

구성 요소	기능
MCP 서버 (stdio)	FastMCP 3.1.0+ 도구: 에이전트, 세션, 채널, 라우팅, 스킬, 게이트웨이, 보안, Moltbook. Cursor/Claude Desktop용.
웹앱 (React + Vite + Tailwind)	포트 5180의 대시보드: 시작 페이지, AI(Ollama), 채널, 경로, 다이어그램, 통계, Moltbook, 통합, Clawnews, 스킬, 보안, 랜딩 생성(랜딩 사이트 생성기), 설정.
webapp_api (FastAPI)	포트 5181의 백엔드: /api/ask, /api/gateway/status, /api/skills, /api/clawnews, /api/ollama/*, /api/channels, /api/routing, /api/openclaw/status, /api/landing-page.

에이전트 실행, 채널/경로/스킬 관리, Moltbook 사용을 위한 통합 공간이며, OpenClaw와 Moltbook은 별도로 유지됩니다.

설치 및 실행

클론 기반 또는 MCPB 번들 방식을 사용합니다. **INSTALL.md**를 참조하여 저장소 클론, 소스에서 설치, MCP 전용 또는 웹앱(API + 프론트엔드), 원샷 스크립트, 설정, 로깅, 검사를 수행하세요.

MCPB: 호환되는 클라이언트로 클릭 한 번으로 가져올 수 있는 표준 openclaw-molt-mcp.mcpb 번들을 사용할 수 있습니다.

저장소 구조

src/openclaw_molt_mcp/ MCP 서버 및 도구
webapp/ React 대시보드 (포트 5180)
webapp_api/ FastAPI 백엔드 (포트 5181)
scripts/ install.ps1, install.bat, start.ps1, start.bat, check.ps1, serve_logs.ps1, mcpb-build.ps1
snippets/ MCP 설정 스니펫 (snippets/mcp-config-openclaw-molt-mcp.json); INSTALL.md 및 mcp-central-docs 패턴 참조

아키텍처 데이터 흐름, MCP 대 API.

문서

문서	설명
LICENSE	MIT 라이선스
CONTRIBUTING.md	기여 방법
INSTALL.md	설치, 실행, 설정, 검사
docs/README_INDEX.md	문서 색인
docs/README_WEBAPP.md	웹앱 페이지, API, 로거
docs/README_openclaw_molt_mcp_TOOLS.md	MCP 도구
docs/README_OPENCLAW.md	OpenClaw (외부)
docs/README_MOLTBOOK.md	Moltbook (외부)
docs/HOW_THIS_WAS_MADE.md	제작 과정 (vibecode, Cursor, 하루)
SECURITY.md	위협, 강화

보안

OpenClaw에는 주요 보안 위험이 있습니다. clawd_security를 사용하고, VM 및 루프백 사용을 권장합니다. SECURITY.md, docs/SECURITY_HARDENING.md를 참조하세요.

저장소 매니페스트 (LLM 스크레이퍼)

파일	트리거	목적
glama.json	Glama GitHub 스크레이퍼	MCP 서버 목록: 소유권 주장, 메타데이터, Docker, 사용량. `$schema` + `maintainers`(GitHub 사용자 이름) 필요. 변경 후 Glama에서 주장 흐름을 다시 실행하세요.
llms.txt	Gitingest, llmstxt.org	LLM 친화적 매니페스트: H1 + 블록인용 요약 + 링크가 포함된 ## 섹션. LLM을 위한 저장소 수집 개선 (예: `gitingest.com/sandraschi/openclaw-molt-mcp`).

기타 스크레이퍼: 추가 파일이 필요하지 않습니다. Gitingest는 저장소를 수집하며(저장소 URL에서 github.com을 gitingest.com으로 대체), llms.txt는 큐레이팅된 진입점을 제공합니다. Glama는 glama.json을 사용하는 주요 MCP 디렉토리 스크레이퍼이며, 다른 스크레이퍼(예: Cursor의 MCP 검색)는 매니페스트 없이 GitHub를 크롤링할 수 있습니다.

참조

이 README는 GitHub 저장소 페이지에서 잘 렌더링되도록 서식이 지정되었습니다(pretty-printed).

설치

사전 요구 사항

uv 설치됨 (권장)
Python 3.12+

빠른 시작

uvx를 통해 즉시 실행:

uvx openclaw-molt-mcp

Claude Desktop 통합

claude_desktop_config.json에 추가:

"mcpServers": {
  "openclaw-molt-mcp": {
    "command": "uv",
    "args": ["--directory", "D:/Dev/repos/openclaw-molt-mcp", "run", "openclaw-molt-mcp"]
  }
}

🛡️ 산업용 품질 스택

이 프로젝트는 고충실도 에이전트 오케스트레이션을 위한 SOTA 14.1 산업 표준을 준수합니다:

Python (코어): 린팅 및 포맷팅을 위한 Ruff. 코어 핸들러 내 print 문에 대한 무관용 원칙(T201).
웹앱 (UI): 밀리초 단위 린팅을 위한 Biome. 엄격한 noConsoleLog 적용.
프로토콜 준수: 충돌 방지 JSON-RPC 통신을 보장하기 위한 강화된 stdout/stderr 격리.
자동화: 모든 운영을 위한 Justfile 레시피(just lint, just fix, just dev).
보안: bandit 및 safety를 통한 자동 감사.

clawd-mcp