diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json index 4bac3f1..d77d359 100644 --- a/.claude-plugin/marketplace.json +++ b/.claude-plugin/marketplace.json @@ -4,12 +4,12 @@ "name": "TTG", "email": "rastasi@gmail.com" }, - "description": "TTG belső Claude Code plugin marketplace", + "description": "TTG internal Claude Code plugin marketplace", "plugins": [ { "name": "redmine-mcp", "source": "./plugins/redmine-mcp", - "description": "Redmine MCP szerver — issue-k, projektek, időrögzítés, wiki és keresés a Redmine REST API-n keresztül.", + "description": "Redmine MCP server — issues, projects, time tracking, wiki and search via the Redmine REST API.", "version": "0.1.0", "author": { "name": "TTG" @@ -18,7 +18,7 @@ { "name": "grav-mcp", "source": "./plugins/grav-mcp", - "description": "Grav CMS MCP szerver — oldalak, média, konfiguráció, felhasználók, csomagkezelő, scheduler, webhookok és flex objektumok a Grav REST API-n keresztül.", + "description": "Grav CMS MCP server — pages, media, configuration, users, package manager, scheduler, webhooks and flex objects via the Grav REST API.", "version": "0.1.0", "author": { "name": "TTG" diff --git a/README.md b/README.md index faaa877..f4fdbf3 100644 --- a/README.md +++ b/README.md @@ -1,11 +1,11 @@ # TTG Marketplace -Claude Code plugin marketplace, két pluginnal: +Claude Code plugin marketplace with two plugins: -- **redmine-mcp** — függőségmentes Node.js MCP szerver a [Redmine REST API](https://www.redmine.org/projects/redmine/wiki/rest_api)-hoz -- **grav-mcp** — függőségmentes Node.js MCP szerver a [Grav CMS REST API](https://learn.getgrav.org/20/api/endpoints)-hoz +- **redmine-mcp** — dependency-free Node.js MCP server for the [Redmine REST API](https://www.redmine.org/projects/redmine/wiki/rest_api) +- **grav-mcp** — dependency-free Node.js MCP server for the [Grav CMS REST API](https://learn.getgrav.org/20/api/endpoints) -## Telepítés +## Installation ``` /plugin marketplace add /Users/tasi/Work/TTG/ttg-marketplace @@ -13,60 +13,60 @@ Claude Code plugin marketplace, két pluginnal: /plugin install grav-mcp@ttg-marketplace ``` -(Git repóból: `/plugin marketplace add `.) +(From a git repo: `/plugin marketplace add `.) -Telepítés után: `/reload-plugins` vagy új session. +After installing: `/reload-plugins` or start a new session. ## redmine-mcp -Telepítéskor kért beállítások: +Settings requested at install time: -| Beállítás | Leírás | +| Setting | Description | |---|---| -| `redmine_url` | A Redmine példány alap URL-je, pl. `https://redmine.example.com` | -| `redmine_api_key` | Saját fiók → jobb oldalt „API hozzáférési kulcs" (az adminnak engedélyeznie kell: Adminisztráció → Beállítások → API → REST szolgáltatás engedélyezése) | +| `redmine_url` | Base URL of the Redmine instance, e.g. `https://redmine.example.com` | +| `redmine_api_key` | My account → "API access key" on the right (the administrator must enable it: Administration → Settings → API → Enable REST web service) | -**Issue-k:** `redmine_list_issues`, `redmine_get_issue` (journals/attachments/relations include-dal), `redmine_create_issue`, `redmine_update_issue` (mezők + komment a `notes`-szal), `redmine_delete_issue` +**Issues:** `redmine_list_issues`, `redmine_get_issue` (with journals/attachments/relations includes), `redmine_create_issue`, `redmine_update_issue` (fields + comment via `notes`), `redmine_delete_issue` -**Projektek:** `redmine_list_projects`, `redmine_get_project`, `redmine_list_versions` +**Projects:** `redmine_list_projects`, `redmine_get_project`, `redmine_list_versions` -**Időrögzítés:** `redmine_list_time_entries`, `redmine_create_time_entry`, `redmine_update_time_entry`, `redmine_delete_time_entry` +**Time tracking:** `redmine_list_time_entries`, `redmine_create_time_entry`, `redmine_update_time_entry`, `redmine_delete_time_entry` -**Felhasználók:** `redmine_list_users` (admin), `redmine_get_user` (`id="current"` = saját fiók) +**Users:** `redmine_list_users` (admin), `redmine_get_user` (`id="current"` = own account) -**Referencia-adatok:** `redmine_list_metadata` — státuszok, trackerek, prioritások, aktivitások, custom mezők, szerepek, mentett lekérdezések, csoportok, projekt-kategóriák, tagságok +**Reference data:** `redmine_list_metadata` — statuses, trackers, priorities, activities, custom fields, roles, saved queries, groups, project categories, memberships -**Wiki és keresés:** `redmine_list_wiki_pages`, `redmine_get_wiki_page`, `redmine_update_wiki_page` (upsert), `redmine_search` +**Wiki and search:** `redmine_list_wiki_pages`, `redmine_get_wiki_page`, `redmine_update_wiki_page` (upsert), `redmine_search` ## grav-mcp -Telepítéskor kért beállítások: +Settings requested at install time: -| Beállítás | Leírás | +| Setting | Description | |---|---| -| `grav_url` | A Grav site alap URL-je, pl. `https://example.com` (a `/api/v1` automatikusan hozzáfűződik) | -| `grav_api_key` | API kulcs — a Grav adminban a felhasználó fiókjánál hozható létre, `X-API-Key` headerként megy | +| `grav_url` | Base URL of the Grav site, e.g. `https://example.com` (`/api/v1` is appended automatically) | +| `grav_api_key` | API key — created for your user account in the Grav admin, sent as the `X-API-Key` header | -**Oldalak:** `grav_list_pages` (keresés, template/parent/published szűrők), `grav_get_page` (markdown vagy renderelt HTML, gyerekek, fordítás-metaadatok), `grav_create_page`, `grav_update_page`, `grav_delete_page`, `grav_move_page`, `grav_copy_page`, `grav_reorder_pages`, `grav_translate_page`, `grav_list_taxonomy` +**Pages:** `grav_list_pages` (search, template/parent/published filters), `grav_get_page` (markdown or rendered HTML, children, translation metadata), `grav_create_page`, `grav_update_page`, `grav_delete_page`, `grav_move_page`, `grav_copy_page`, `grav_reorder_pages`, `grav_translate_page`, `grav_list_taxonomy` -**Média:** `grav_list_media` (site- vagy oldal-szintű), `grav_upload_media` (helyi fájl feltöltése multipart-tal), `grav_delete_media`, `grav_manage_media` (fájl átnevezés, mappa létrehozás/törlés/átnevezés) +**Media:** `grav_list_media` (site- or page-level), `grav_upload_media` (uploads a local file via multipart), `grav_delete_media`, `grav_manage_media` (rename file, create/delete/rename folders) -**Konfiguráció:** `grav_get_config`, `grav_update_config` (deep-merge; system, site, plugins/{name}, themes/{name} scope-ok) +**Configuration:** `grav_get_config`, `grav_update_config` (deep-merge; system, site, plugins/{name}, themes/{name} scopes) -**Felhasználók:** `grav_list_users`, `grav_get_user` (`username="me"` = saját fiók), `grav_create_user`, `grav_update_user`, `grav_delete_user` +**Users:** `grav_list_users`, `grav_get_user` (`username="me"` = own account), `grav_create_user`, `grav_update_user`, `grav_delete_user` -**Rendszer:** `grav_system_info`, `grav_clear_cache`, `grav_get_logs`, `grav_manage_backups` +**System:** `grav_system_info`, `grav_clear_cache`, `grav_get_logs`, `grav_manage_backups` -**Blueprintek:** `grav_get_blueprint` — page template-ek, user, permissions, config, plugin, téma és flex sémák +**Blueprints:** `grav_get_blueprint` — page templates, user, permissions, config, plugin, theme and flex schemas -**Csomagkezelő (GPM):** `grav_list_packages` (telepített vagy repository), `grav_check_updates`, `grav_manage_package` (install/remove/update/update-all/core upgrade) +**Package manager (GPM):** `grav_list_packages` (installed or repository), `grav_check_updates`, `grav_manage_package` (install/remove/update/update-all/core upgrade) -**Egyéb:** `grav_scheduler` (jobok, státusz, history, futtatás), `grav_dashboard` (statisztikák, népszerűség, értesítések), `grav_manage_webhooks`, flex objektumok: `grav_list_flex`, `grav_get_flex_object`, `grav_save_flex_object`, `grav_delete_flex_object` +**Other:** `grav_scheduler` (jobs, status, history, run), `grav_dashboard` (stats, popularity, notifications), `grav_manage_webhooks`, flex objects: `grav_list_flex`, `grav_get_flex_object`, `grav_save_flex_object`, `grav_delete_flex_object` -## Megjegyzések +## Notes -- Egyik szervernek sincs npm függősége (Node 18+ beépített `fetch`), build lépés sincs. -- Kézi próba plugin nélkül: +- Neither server has any npm dependencies (Node 18+ built-in `fetch`), and there is no build step. +- Manual testing without the plugin: ```sh REDMINE_URL=https://redmine.example.com REDMINE_API_KEY=xxx \ node plugins/redmine-mcp/server/index.js diff --git a/plugins/grav-mcp/.claude-plugin/plugin.json b/plugins/grav-mcp/.claude-plugin/plugin.json index 1c79c6b..7360736 100644 --- a/plugins/grav-mcp/.claude-plugin/plugin.json +++ b/plugins/grav-mcp/.claude-plugin/plugin.json @@ -2,7 +2,7 @@ "name": "grav-mcp", "displayName": "Grav MCP", "version": "0.1.0", - "description": "Grav CMS MCP szerver — oldalak, média, konfiguráció, felhasználók, csomagkezelő, scheduler, webhookok és flex objektumok a Grav REST API-n keresztül.", + "description": "Grav CMS MCP server — pages, media, configuration, users, package manager, scheduler, webhooks and flex objects via the Grav REST API.", "author": { "name": "TTG", "email": "rastasi@gmail.com" @@ -21,12 +21,12 @@ "grav_url": { "type": "string", "title": "Grav URL", - "description": "A Grav site alap URL-je, pl. https://example.com (a /api/v1 automatikusan hozzáfűződik)" + "description": "Base URL of the Grav site, e.g. https://example.com (/api/v1 is appended automatically)" }, "grav_api_key": { "type": "string", - "title": "Grav API kulcs", - "description": "API kulcs a Grav adminban a felhasználónál (vagy POST /api/v1/users/{username}/api-keys)", + "title": "Grav API key", + "description": "API key created for your user in the Grav admin (or via POST /api/v1/users/{username}/api-keys)", "sensitive": true } } diff --git a/plugins/redmine-mcp/.claude-plugin/plugin.json b/plugins/redmine-mcp/.claude-plugin/plugin.json index 58f993c..88382bc 100644 --- a/plugins/redmine-mcp/.claude-plugin/plugin.json +++ b/plugins/redmine-mcp/.claude-plugin/plugin.json @@ -2,7 +2,7 @@ "name": "redmine-mcp", "displayName": "Redmine MCP", "version": "0.1.0", - "description": "Redmine MCP szerver — issue-k, projektek, időrögzítés, felhasználók, wiki és keresés a Redmine REST API-n keresztül.", + "description": "Redmine MCP server — issues, projects, time tracking, users, wiki and search via the Redmine REST API.", "author": { "name": "TTG", "email": "rastasi@gmail.com" @@ -21,12 +21,12 @@ "redmine_url": { "type": "string", "title": "Redmine URL", - "description": "A Redmine példány alap URL-je, pl. https://redmine.example.com" + "description": "Base URL of the Redmine instance, e.g. https://redmine.example.com" }, "redmine_api_key": { "type": "string", - "title": "Redmine API kulcs", - "description": "Saját fiók → API hozzáférési kulcs (az adminnak engedélyeznie kell a REST API-t)", + "title": "Redmine API key", + "description": "My account → API access key (the administrator must enable the REST API)", "sensitive": true } }