init: project scaffold

2026-05-08 03:11:34 +00:00
commit 83d17132a5
1 changed files with 92 additions and 0 deletions
@@ -0,0 +1,92 @@
+# Advanced MCP Plugin — by AskTam
+
+A WordPress plugin that exposes full AI control over your WordPress site via the **Model Context Protocol (MCP)**.
+
+Connect Claude, GPT-4, or any MCP-compatible AI to your WordPress site and give it hands-on access to posts, pages, users, media, plugins, settings, WooCommerce, and more.
+
+---
+
+## Architecture
+
+```
+AI Client (Claude / any MCP client)
+        │
+        │  SSE / HTTP  (MCP protocol)
+        ▼
+WordPress REST Endpoint
+  /wp-json/asktam-mcp/v1/sse
+        │
+        ▼
+MCP Server (PHP, SSE transport)
+        │
+        ▼
+Tool Handlers
+  ├── Posts & Pages
+  ├── Media
+  ├── Users
+  ├── Taxonomy
+  ├── Options
+  ├── Plugins & Themes
+  ├── Menus
+  ├── Comments
+  ├── SEO Meta (Yoast / RankMath)
+  ├── WooCommerce (if active)
+  └── Site Health / Info
+```
+
+---
+
+## Authentication
+
+API Key based — simple, secure, no OAuth overhead for server-to-server AI use.
+
+- Keys managed in **WP Admin → AskTam MCP → API Keys**
+- Per-key capability scopes: `read`, `write`, `admin`, `woocommerce`
+- Pass key in request header: `X-MCP-API-Key: your_key_here`
+
+---
+
+## MCP Endpoint
+
+```
+https://yoursite.com/wp-json/asktam-mcp/v1/sse
+```
+
+Add to any MCP client as a remote SSE server with the header `X-MCP-API-Key`.
+
+---
+
+## Tools
+
+| Category | Tools |
+|---|---|
+| Posts | list_posts, get_post, create_post, update_post, delete_post |
+| Pages | list_pages, get_page, create_page, update_page, delete_page |
+| Media | list_media, get_media, upload_media, update_media, delete_media |
+| Users | list_users, get_user, create_user, update_user, delete_user |
+| Taxonomy | list_terms, get_term, create_term, update_term, delete_term |
+| Options | get_option, update_option, list_options |
+| Plugins | list_plugins, activate_plugin, deactivate_plugin |
+| Themes | list_themes, get_active_theme, switch_theme |
+| Menus | list_menus, get_menu, update_menu |
+| Comments | list_comments, approve_comment, spam_comment, delete_comment |
+| SEO | get_seo_meta, update_seo_meta |
+| WooCommerce | list_products, get_product, create_product, update_product, list_orders, get_order, update_order_status |
+| Site | get_site_info, get_health, run_cron |
+
+---
+
+## Installation
+
+1. Upload `advanced-mcp-plugin/` to `/wp-content/plugins/`
+2. Activate via WP Admin → Plugins
+3. Go to **AskTam MCP → API Keys** → generate a key
+4. Add endpoint to your MCP client
+
+---
+
+## Requirements
+
+- WordPress 6.0+
+- PHP 8.0+
+- WooCommerce 7.0+ (optional, for WC tools)