AI-powered WordPress 개발을 위한 MCP 서버 및 프로젝트 컨텍스트를 제공하는 Local add-on. Claude Code, Cursor, Windsurf, VS Code Copilot 및 MCP 클라이언트와 함께 작동합니다.

그것은 무엇을

로컬 사이트에 "Enable"을 클릭하면 add-on:

1. ** MCP 서버로 사이트를 등록 ** - WP-CLI, 오류 로그, 구성 및 사이트 관리에 AI 도구 액세스를 제공하는 로컬의 주요 프로세스에서 실행 단일 HTTP 서버 ** 2.Writes MCP config (.mcp.json, .cursor/mcp.json, etc.) - 각 에이전트에 대한 올바른 HTTP 엔드포인트와 per-install Bearer 토큰으로 자동 구성 (아래 인증 참조)
2. ** 프로젝트 컨텍스트 ** (CLAUDE.md, .cursorrules] 등) - PHP/MySQL 버전, 활성 플러그인, 테마 및 파일 구조를 포함하여 사이트 컨텍스트 4.Updates .gitignore — MCP config 파일은 이제 생성 된 컨텍스트 파일과 함께 비밀 (곰버 토큰)을 수행하므로 모든 것이 git-ignored이며 아무도 최선을 다하고 있습니다.

그런 다음 선택의 AI 도구에서 사이트 폴더를 열고 갈 준비가되어 있습니다.

건축

MCP 서버는 로컬의 Electron 메인 프로세스 내에서 단일 HTTP 서버로 실행합니다. 사이트당 별도 Node.js 프로세스가 없습니다.

LocalWP Agent Tools

A Local add-on that provides an MCP server and project context for AI-powered WordPress development. Works with Claude Code, Cursor, Windsurf, VS Code Copilot, and any MCP client.

What It Does

When you click “Enable” on a site in Local, the add-on:

1. Registers the site with the MCP server — a single HTTP server running in Local’s main process that gives AI tools access to WP-CLI, error logs, configuration, and site management
2. Writes MCP config (.mcp.json, .cursor/mcp.json, etc.) — auto-configured with the correct HTTP endpoint and the per-install bearer token for each agent (see Authentication below)
3. Generates project context (CLAUDE.md, .cursorrules, etc.) — site context including PHP/MySQL versions, active plugins, theme, and file structure
4. Updates .gitignore — the MCP config files now carry a secret (the bearer token) alongside the generated context files, so all of them are git-ignored and none are committed

Then open the site folder in your AI tool of choice and you’re ready to go.

Architecture

The MCP server runs as a single HTTP server inside Local’s Electron main process — no separate Node.js processes per site. It serves two kinds of endpoint:

http://localhost:{port}/sites/mcp             # global — all of Local
http://localhost:{port}/sites/{siteId}/mcp    # one specific site

The server uses the MCP Streamable HTTP transport. The port is stable across restarts (persisted at ~/.local-agent-tools/port, default 24842).

Sites remain registered even when stopped, so the MCP endpoint is always reachable. Tools that need running services (WP-CLI, database) return appropriate errors; file-based tools (config, logs, site info) work regardless. Config is refreshed on each tool call, so starting a site automatically makes database tools work without reconnecting.

Authentication

Every request to the MCP server needs an Authorization: Bearer header. That header is the only channel; there is no ?token= URL parameter.

The add-on creates the token on first start and stores it at ~/.local-agent-tools/token, with mode 0600 in a 0700 directory. The token survives restarts, and the server checks it in constant time.