wpxmcp

셀프 호스팅 WordPress를 위한 원격 우선 MCP 서버. 콘텐츠, 디자인, 테마, 플러그인, 메뉴, 사용자, 데이터베이스를 모든 MCP 클라이언트에서 관리하세요. WordPress 자격 증명은 모든 노트북이 아니라 Cloudflare Worker Secrets에 보관됩니다.

117개 도구 · 2가지 전송 방식 · 필수 플러그인 0 · MIT

셀프 호스팅 WordPress 6.0+. WordPress.com은 이 프로젝트가 의존하는 REST 엔드포인트를 제공하지 않습니다.

사용 예시

"가격 페이지를 찾아 Pro 등급을 $49로 바꾸고, 실제로 표시되는지 확인해 줘."

find_content_by_url  https://example.com/pricing/
  → id 812, type page — resolved by slug lookup in "page"

update_content  id 812, edits: [{ find: "<strong>$39</strong>", replace: "<strong>$49</strong>" }]
  → updated. 1 replacement. 8,431 characters, unchanged in length.

get_page_html  /pricing/  mode: "summary"
  → still shows $39

잘못된 것은 쓰기가 아니라 페이지 캐시였습니다. 200 상태 코드만 믿는 대신 렌더링된 페이지를 읽었기 때문에 발견할 수 있었습니다.

Related MCP server: wordpress-mcp

왜 이 서버인가

자격 증명을 한곳에 보관. 대부분의 WordPress MCP 서버는 stdio로 실행되므로, 사람 × 사이트마다 노트북에 Application Password가 하나씩 더 놓입니다. 이 서버는 Cloudflare Workers에 배포하고 자격 증명은 Worker Secrets에 저장합니다. 클라이언트는 명령 하나로 교체할 수 있는 베어러 토큰만 보유하면 됩니다. 필요할 때는 로컬에서 stdio로도 실행할 수 있습니다.

실제로 지켜지는 안전장치. 새 글은 기본적으로 초안으로 등록됩니다. 삭제는 휴지통으로 이동합니다. 대량 편집, SQL, search-replace는 먼저 dry-run 으로 실행되고, 그 정확한 인자에 바인딩된 일회용 토큰을 반환합니다. 테마 편집은 격리된 클론에서 이루어집니다. 전체 보기 — 각 항목이 존재한다는 것만 확인했을 뿐 아니라, 실제로 거부하도록 동작하는지까지 검증했습니다.

전체 재작성이 아닌 편집. update_content는 edits: [{find, replace}]를 받습니다. 가격을 고칠 때 3,000단어 페이지를 다시 보낼 필요가 없습니다. 아무것도 일치하지 않는 편집은 조용히 아무것도 안 쓰는 대신 뚜렷하게 실패합니다.

페이지 빌더를 알고 있습니다. Elementor, Divi, Beaver Builder, Bricks, Breakdance는 레이아웃을 post_content가 아닌 post meta에 저장합니다. 잘못된 곳에 쓰여 수정 사항이 사라져버립니다. wpxmcp는 빌더가 소유한 콘텐츠를 감지하고, 에이전트가 먼저 읽도록 playbook을 제공합니다.

REST로 닿을 수 없는 것 전부. WP-CLI, SQL, 테마 파일, 등록되지 않은 메타는 핵심 REST 경로가 없습니다. 선택형 동반 플러그인이 정확히 그 기능을 추가합니다.

개발자뿐 아니라 사이트 소유자도 사용 가능합니다. "새 가격을 반영해 줘", "스팸을 정리해 줘" 같은 결과를 요청하면 에이전트가 예약 플레이북을 불러와 어떤 페이지를 찾았는지 확인하고, 현재 문장을 다시 읽고, 게시 전에 초안으로 만들고, 되돌릴 수 없는 단계가 있으면 명확히 설명하도록 안내합니다.

원격 배포 (권장)

또는 세 가지 명령어:

npm install
openssl rand -hex 32 | npx wrangler secret put WPX_AUTH_TOKEN
npx wrangler secret put WPX_SITES     # your sites JSON, then Ctrl-D
npm run deploy

아무 MCP 클라이언트나 연결:

{
  "mcpServers": {
    "wpxmcp": {
      "type": "http",
      "url": "https://wpxmcp.<your-subdomain>.workers.dev/mcp",
      "headers": { "Authorization": "Bearer <your WPX_AUTH_TOKEN>" }
    }
  }
}

무료 등급은 하루 100,000개 요청을 지원합니다. 전체 가이드 →

또는 로컬에서 실행

git clone https://github.com/alokemajumder/wpxmcp.git
cd wpxmcp && npm install && npm run build
npm run doctor          # checks reachability, auth, capabilities, plugin

claude mcp add wpxmcp -- node /absolute/path/to/wpxmcp/dist/index.js \
  -e WORDPRESS_URL=https://example.com \
  -e WORDPRESS_USERNAME=admin \
  -e "WORDPRESS_APP_PASSWORD=abcd EFGH ijkl MNOP qrst UVWX"

사용자 → 프로필 → Application Passwords에서 Application Password를 만드세요. 두 가지 잘 알려진 함정이 있습니다. WordPress는 HTTPS에서만 이를 제공하고, 일부 호스팅 환경은 Authorization 헤더를 제거해서 자격증명이 올바른데도 401을 반환합니다. test_site가 이것 두 가지 모두 감지합니다. 인증 가이드 →

로컬 전용 추가 기능으로는 create_media가 디스크 경로를 읽을 수 있고, save_skill이 playbook을 저장할 수 있습니다. 그 외에는 모두 동일합니다. 두 전송 방식 모두 같은 도구 세트에서 만들어집니다.

WordPress 플러그인이 필요한가요?

대부분의 작업에는 필요 없습니다. 117개의 도구 중 93개는 아무것도 설치하지 않은 기본 WordPress에서 동작합니다.

나머지 24개는 핵심 WordPress에 자체 REST 경로가 전혀 없는 기능 — WP-CLI, SQL, 테마 파일, show_in_rest 없이 등록된 메타(원가 전 메타 포함, 페이지 빌더와 메타 대부분) — 을 다룹니다. /wp/v2/themes는 WordPress 7.1에서도 읽기 전용이므로 테마 활성화도 사이트 쪽 코드가 필요합니다.

이러한 기능을 제공하는 모든 WordPress MCP 도구는 사이트 쪽 코드를 동봉합니다. 공식 MCP Adapter도 포함하여 말이죠. 차이점은 우리 경우 그 코드가 선택사항이고, 필요로 하는 각 도구가 자기 이름으로 그 점을 밝힌다는 것입니다.

WordPress/mcp-adapter는 필요 없습니다. 그건 대체 아키텍처이지 의존성이 아닙니다. Adapter가 연결하는 Abilities API는 WordPress 코어에 있고, wpxmcp는 직접 호출합니다.

전체 비교와 근거 →; 플러그인 상세 →

할 수 있는 것

전체 도구 참조 →

문서

상태

v1.0.0. Node 20/22/24 및 PHP 7.4/8.3 CI, 그리고 모든 push마다 building workflow build를 검증합니다.

실제 운영 WordPress 7.1 설치 환경해서만 테스트가 아니라, 실제로 117수록 도구를 모두 실행했고 dry-run → 확인 → 적용 전체 진행 과정을 검증했으며, 동일한 서버를 HTTP로도 다시 확인했습니다. 모든 보호 장치가 거부량을 확인했습니다(예: live theme.write, board Travel, file traversal, protected 옵션이나, allowlist에 없는 명령, stacked SQL). 이를 통해 12개의 실제 버그를 발견해 수정했습니다. 공식 문서에는 나타나지만 실제 core registration과 이야지하지 않는 ability routes, 그리고 Cloudflare는 isolate 간에 유지되지 못한 confirm 토큰이 여기 포함됩니다.

테스트 스위트는 audit/에 있고 어느 폐기용 WordPress에든 다시 실행할 수 있습니다: npm run audit

다음에 추가 예정: WooCommerce, ACF, multisite 위한 playbook 더 보기, 각 builder 고유의 directory 경로를 통해 저장하는 page builder write path, allowlist에 추가할 WP-CLI 와. 이슈와 PR과 pull request는 언제나 환영합니다. — CONTRIBUTING.md 참고.

개발

npm install && npm run build
npm test            # 68 tests, no network needed
npm run cf:dev      # the worker locally at :8787/mcp

tool 팩 추가는 defineTool({...}) 하나로 됩니다. 두 전송 방식 모두에 자동으로 나타납니다.

라이선스

MIT — LICENSE를 참고하세요. WordPress Foundation, Automattic 혹은 Cloudflare와 관계없습니다.