@oneentry/mcp-server 1.1.6 → 1.1.8

package/README.md

@@ -6,13 +6,13 @@ MCP server for OneEntry SDK — gives AI assistants (Claude Code, Cursor, Windsu
 
 ## Two ways to connect
 
-|              | npm package                   | Remote server                                |
-| ------------ | ----------------------------- | -------------------------------------------- |
-| **Install**  | `npx -y @oneentry/mcp-server@latest` | No install — just a URL               |
-| **Works in** | Claude Code only              | Claude Code, Cursor, Windsurf                |
-| **Requires** | Nothing                       | OneEntry project token + URL                 |
-| **Provides** | Rules + Skills (context docs) | Rules + Skills + **SDK documentation tools** |
-| **Best for** | Quick local setup             | Full AI-assisted development                 |
+|              | npm package                          | Remote server                                |
+| ------------ | ------------------------------------ | -------------------------------------------- |
+| **Install**  | `npx -y @oneentry/mcp-server@latest` | No install — just a URL                      |
+| **Works in** | Claude Code only                     | Claude Code, Cursor, Windsurf                |
+| **Requires** | Nothing                              | OneEntry project token + URL                 |
+| **Provides** | Rules + Skills (context docs)        | Rules + Skills + **SDK documentation tools** |
+| **Best for** | Quick local setup                    | Full AI-assisted development                 |
 
 ---
 
@@ -31,16 +31,16 @@ You will need:
 
 ```json
 {
-    "mcpServers": {
-        "oneentry": {
-            "type": "streamable-http",
-            "url": "https://mcp-sdk-js.oneentry.cloud/mcp",
-            "headers": {
-                "X-OneEntry-Token": "YOUR_TOKEN",
-                "X-OneEntry-URL": "https://yourproject.oneentry.cloud"
-            }
-        }
+  "mcpServers": {
+    "oneentry": {
+      "type": "streamable-http",
+      "url": "https://mcp-sdk-js.oneentry.cloud/mcp",
+      "headers": {
+        "X-OneEntry-Token": "YOUR_TOKEN",
+        "X-OneEntry-URL": "https://yourproject.oneentry.cloud"
+      }
     }
+  }
 }
 ```
 
@@ -48,15 +48,15 @@ You will need:
 
 ```json
 {
-    "mcpServers": {
-        "oneentry": {
-            "url": "https://mcp-sdk-js.oneentry.cloud/mcp",
-            "headers": {
-                "X-OneEntry-Token": "YOUR_TOKEN",
-                "X-OneEntry-URL": "https://yourproject.oneentry.cloud"
-            }
-        }
+  "mcpServers": {
+    "oneentry": {
+      "url": "https://mcp-sdk-js.oneentry.cloud/mcp",
+      "headers": {
+        "X-OneEntry-Token": "YOUR_TOKEN",
+        "X-OneEntry-URL": "https://yourproject.oneentry.cloud"
+      }
     }
+  }
 }
 ```
 
@@ -64,14 +64,14 @@ You will need:
 
 Add via **Settings → MCP Servers**:
 
-```
+```text
 URL:            https://mcp-sdk-js.oneentry.cloud/mcp?token=YOUR_TOKEN&url=https://yourproject.oneentry.cloud
 Authentication: None
 ```
 
 ### Alternative — custom headers (instead of query params)
 
-```
+```text
 URL:              https://mcp-sdk-js.oneentry.cloud/mcp
 X-OneEntry-Token: YOUR_TOKEN
 X-OneEntry-URL:   https://yourproject.oneentry.cloud
@@ -81,48 +81,68 @@ X-OneEntry-URL:   https://yourproject.oneentry.cloud
 
 ## Option B — npm package (Claude Code only)
 
-Serves rules and skills as readable context documents. No token required.
+Serves rules and skills as readable context documents.
+
+You can optionally add your OneEntry project URL and token via `env` — this lets the `/inspect-api` skill work without reading `.env.local` or asking you each time.
 
 **npx — no install:**
 
 ```json
 {
-    "mcpServers": {
-        "oneentry": {
-            "command": "npx",
-            "args": ["-y", "@oneentry/mcp-server@latest"]
-        }
+  "mcpServers": {
+    "oneentry": {
+      "command": "npx",
+      "args": ["-y", "@oneentry/mcp-server@latest"],
+      "env": {
+        "ONEENTRY_URL": "https://yourproject.oneentry.cloud",
+        "ONEENTRY_TOKEN": "YOUR_TOKEN"
+      }
     }
+  }
 }
 ```
 
-**Global install:**
+**Local install (per project):**
 
 ```bash
-npm install -g @oneentry/mcp-server
+npm install --save-dev @oneentry/mcp-server
 ```
 
 ```json
 {
-    "mcpServers": {
-        "oneentry": {
-            "command": "oneentry-mcp"
-        }
+  "mcpServers": {
+    "oneentry": {
+      "command": "./node_modules/.bin/oneentry-mcp",
+      "env": {
+        "ONEENTRY_URL": "https://yourproject.oneentry.cloud",
+        "ONEENTRY_TOKEN": "YOUR_TOKEN"
+      }
     }
+  }
 }
 ```
 
----
-
-## ⚠️ Required for Claude Code: add to your project's CLAUDE.md
-
-After connecting the MCP server, create or edit `CLAUDE.md` in the root of your project and add:
+**Global install:**
 
+```bash
+npm install -g @oneentry/mcp-server
 ```
-This project uses OneEntry CMS. MCP server oneentry is connected — use it to get SDK documentation, rules and code examples.
+
+```json
+{
+  "mcpServers": {
+    "oneentry": {
+      "command": "oneentry-mcp",
+      "env": {
+        "ONEENTRY_URL": "https://yourproject.oneentry.cloud",
+        "ONEENTRY_TOKEN": "YOUR_TOKEN"
+      }
+    }
+  }
+}
 ```
 
-> **Without this, Claude Code may not use the MCP server automatically.**
+> `env` is optional. If omitted, `/inspect-api` reads from `.env.local` / `.env`, or asks you for the URL and token.
 
 ---
 
@@ -146,13 +166,26 @@ Read them in Claude Code by typing `@oneentry://rules/<name>`:
 | `oneentry://rules/localization`     | Localization, locale from params       |
 | `oneentry://rules/product-statuses` | Product statuses rules                 |
 
+## Available tools
+
+Called automatically by the AI when needed:
+
+| Tool                 | Description                                                        |
+| -------------------- | ------------------------------------------------------------------ |
+| `load-context`       | Reload the full OneEntry SDK instructions into context             |
+| `get-rule`           | Fetch a specific rule by name                                      |
+| `get-skill`          | Fetch a specific skill by name (supports `$ARGUMENTS` placeholder) |
+| `get-project-config` | Return project URL and token from `.mcp.json` env                  |
+
+---
+
 ## Available prompts (skills)
 
 Invoke in Claude Code with `/mcp__oneentry__<name>`:
 
 | Prompt                       | Description                                           |
 | ---------------------------- | ----------------------------------------------------- |
-| `oneentry-context`           | Load full SDK context at session start                |
+| `oneentry-context`           | Reload full SDK context manually                      |
 | `setup-nextjs`               | Initialize Next.js project                            |
 | `setup-oneentry`             | Initialize SDK in a Next.js project                   |
 | `inspect-api`                | Inspect real API markers and structure                |

package/dist/config.d.ts

@@ -4,3 +4,7 @@ export declare const USER_AGENT: string;
 export declare const CLAUDE_MD_PATH = "CLAUDE.md";
 export declare const BASE_URL: string;
 export declare const TTL_MS: number;
+/** OneEntry project URL — set via ONEENTRY_URL in .mcp.json env */
+export declare const ONEENTRY_URL: string;
+/** OneEntry App Token — set via ONEENTRY_TOKEN in .mcp.json env */
+export declare const ONEENTRY_TOKEN: string;

package/dist/config.js

@@ -8,3 +8,7 @@ export const CLAUDE_MD_PATH = "CLAUDE.md";
 export const BASE_URL = process.env.ONEENTRY_MCP_BASE_URL ??
     "https://raw.githubusercontent.com/ONEENTRY-PLATFORM/oneentry-sdk-rules/main";
 export const TTL_MS = Number(process.env.ONEENTRY_MCP_CACHE_TTL_MS) || 5 * 60 * 1000;
+/** OneEntry project URL — set via ONEENTRY_URL in .mcp.json env */
+export const ONEENTRY_URL = process.env.ONEENTRY_URL ?? "";
+/** OneEntry App Token — set via ONEENTRY_TOKEN in .mcp.json env */
+export const ONEENTRY_TOKEN = process.env.ONEENTRY_TOKEN ?? "";

package/dist/index.js

@@ -4,128 +4,232 @@ import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js"
 import { z } from "zod";
 import { fetchContent } from "./content.js";
 import { RULES, SKILLS } from "./registry.js";
-import { CLAUDE_MD_PATH, SERVER_NAME, VERSION } from "./config.js";
-// ---------------------------------------------------------------------------
-// Server
-// ---------------------------------------------------------------------------
-const server = new McpServer({ name: SERVER_NAME, version: VERSION });
-// ---------------------------------------------------------------------------
-// Resources — rules + CLAUDE.md
-// ---------------------------------------------------------------------------
-server.registerResource("OneEntry SDK — Main Instructions (CLAUDE.md)", "oneentry://claude-md", {
-    description: "Full system prompt with OneEntry SDK rules, patterns, anti-hallucination guidelines and module reference",
-    mimeType: "text/markdown",
-}, async (uri) => {
-    const text = await fetchContent(CLAUDE_MD_PATH);
-    return { contents: [{ uri: uri.toString(), mimeType: "text/markdown", text }] };
-});
-for (const rule of RULES) {
-    server.registerResource(rule.displayName, `oneentry://rules/${rule.name}`, { description: rule.description, mimeType: "text/markdown" }, async (uri) => {
-        const text = await fetchContent(rule.path);
+import { CLAUDE_MD_PATH, ONEENTRY_TOKEN, ONEENTRY_URL, SERVER_NAME, VERSION } from "./config.js";
+/**
+ * Точка входа MCP-сервера OneEntry SDK.
+ *
+ * ## Архитектура
+ *
+ * MCP (Model Context Protocol) — протокол, по которому AI-клиент (Claude Code,
+ * Cursor, Windsurf) общается с внешним сервером контекста. Сервер предоставляет
+ * три типа объектов:
+ *
+ * - **Resources** — документы, которые AI может прочитать по URI (`@oneentry://...`).
+ *   Аналог файловой системы: клиент сам решает, когда читать.
+ *
+ * - **Prompts** — готовые шаблоны сообщений (скиллы). AI-клиент подставляет их
+ *   в чат по команде пользователя (`/mcp__oneentry__<name>`).
+ *
+ * - **Tools** — функции, которые AI вызывает автоматически по ситуации.
+ *   Возвращают текст прямо в контекст разговора.
+ *
+ * ## Как загружается CLAUDE.md
+ *
+ * При подключении MCP-сервер отвечает на `initialize`-запрос клиента и
+ * включает в ответ поле `instructions`. Claude Code читает это поле и
+ * автоматически добавляет его в системный контекст сессии — без каких-либо
+ * дополнительных действий от пользователя.
+ *
+ * Поэтому CLAUDE.md загружается **первым делом**, до регистрации всего
+ * остального, и передаётся в конструктор `McpServer` через `{ instructions }`.
+ */
+async function main() {
+    // ---------------------------------------------------------------------------
+    // Загрузка CLAUDE.md и создание сервера
+    // ---------------------------------------------------------------------------
+    /**
+     * Загружаем CLAUDE.md с GitHub до создания сервера — нам нужно передать
+     * содержимое в конструктор как `instructions`.
+     *
+     * `instructions` — стандартное поле MCP InitializeResult. Клиент получает
+     * его в ответ на первый `initialize`-запрос и автоматически включает в
+     * системный промпт сессии. Именно так другие MCP-серверы "работают сразу"
+     * без дополнительной настройки CLAUDE.md в проекте.
+     */
+    const instructions = await fetchContent(CLAUDE_MD_PATH);
+    const server = new McpServer({ name: SERVER_NAME, version: VERSION }, { instructions });
+    // ---------------------------------------------------------------------------
+    // Resources — документы для явного чтения по URI
+    // ---------------------------------------------------------------------------
+    /**
+     * Главный ресурс: полный CLAUDE.md как документ.
+     * Доступен в Claude Code по `@oneentry://claude-md`.
+     * Полезен если нужно явно переподгрузить контекст или вставить его в чат.
+     */
+    server.registerResource("OneEntry SDK — Main Instructions (CLAUDE.md)", "oneentry://claude-md", {
+        description: "Full system prompt with OneEntry SDK rules, patterns, anti-hallucination guidelines and module reference",
+        mimeType: "text/markdown",
+    }, async (uri) => {
+        const text = await fetchContent(CLAUDE_MD_PATH);
         return { contents: [{ uri: uri.toString(), mimeType: "text/markdown", text }] };
     });
-}
-// ---------------------------------------------------------------------------
-// Prompts — skills
-// ---------------------------------------------------------------------------
-// Special prompt: load full context from CLAUDE.md
-server.registerPrompt("oneentry-context", {
-    description: "Load full OneEntry SDK context — system instructions, rules and anti-hallucination guidelines. Use this at the start of a session.",
-}, async () => {
-    const text = await fetchContent(CLAUDE_MD_PATH);
-    return {
-        description: "OneEntry SDK — full system context loaded",
-        messages: [
-            {
-                role: "user",
-                content: {
-                    type: "text",
-                    text: `The following are the complete instructions and rules for working with OneEntry SDK. Apply them to all subsequent code generation:\n\n${text}`,
-                },
-            },
-        ],
-    };
-});
-// Skills
-for (const skill of SKILLS) {
-    if (skill.hasArguments) {
-        server.registerPrompt(skill.name, {
-            description: skill.description,
-            argsSchema: {
-                arguments: z
-                    .string()
-                    .optional()
-                    .describe(skill.argumentDescription ?? "Optional arguments"),
-            },
-        }, async (args) => {
-            let text = await fetchContent(skill.path);
-            // Replace $ARGUMENTS placeholder (used in inspect-api and create-page skills)
-            if (args.arguments) {
-                text = text.replace(/\$ARGUMENTS/g, args.arguments);
-            }
-            return {
-                description: skill.description,
-                messages: [{ role: "user", content: { type: "text", text } }],
-            };
+    /**
+     * Отдельные правила из registry.ts — каждое доступно по своему URI:
+     * `@oneentry://rules/linting`, `@oneentry://rules/tokens`, и т.д.
+     *
+     * Ресурсы удобны когда нужно прочитать только одно конкретное правило,
+     * не загружая весь CLAUDE.md целиком.
+     */
+    for (const rule of RULES) {
+        server.registerResource(rule.displayName, `oneentry://rules/${rule.name}`, { description: rule.description, mimeType: "text/markdown" }, async (uri) => {
+            const text = await fetchContent(rule.path);
+            return { contents: [{ uri: uri.toString(), mimeType: "text/markdown", text }] };
         });
     }
-    else {
-        server.registerPrompt(skill.name, { description: skill.description }, async () => {
-            const text = await fetchContent(skill.path);
-            return {
+    // ---------------------------------------------------------------------------
+    // Prompts (скиллы) — шаблоны сообщений для вставки в чат
+    // ---------------------------------------------------------------------------
+    /**
+     * Специальный промпт для ручной перезагрузки контекста.
+     * Вызывается командой `/mcp__oneentry__oneentry-context`.
+     *
+     * Возвращает CLAUDE.md завёрнутым в сообщение с ролью `user` — это
+     * стандартный способ подачи контекста через MCP Prompts API.
+     * Клиент вставляет это сообщение в историю чата.
+     */
+    server.registerPrompt("oneentry-context", {
+        description: "Load full OneEntry SDK context — system instructions, rules and anti-hallucination guidelines. Use this at the start of a session.",
+    }, async () => {
+        const text = await fetchContent(CLAUDE_MD_PATH);
+        return {
+            description: "OneEntry SDK — full system context loaded",
+            messages: [
+                {
+                    role: "user",
+                    content: {
+                        type: "text",
+                        text: `The following are the complete instructions and rules for working with OneEntry SDK. Apply them to all subsequent code generation:\n\n${text}`,
+                    },
+                },
+            ],
+        };
+    });
+    /**
+     * Регистрируем все скиллы из registry.ts как MCP Prompts.
+     * Каждый скилл — это markdown-инструкция для выполнения конкретной задачи
+     * (создание страницы, формы, корзины и т.д.).
+     *
+     * Скиллы делятся на два типа:
+     * - `hasArguments: true` — принимают аргумент (например, маркер страницы),
+     *   который подставляется вместо плейсхолдера `$ARGUMENTS` в тексте скилла.
+     * - без аргументов — возвращают текст как есть.
+     */
+    for (const skill of SKILLS) {
+        if (skill.hasArguments) {
+            server.registerPrompt(skill.name, {
                 description: skill.description,
-                messages: [{ role: "user", content: { type: "text", text } }],
-            };
-        });
-    }
-}
-// ---------------------------------------------------------------------------
-// Tools
-// ---------------------------------------------------------------------------
-server.registerTool("load-context", {
-    description: "IMPORTANT: Call this tool automatically at the start of EVERY session when working on a project that uses OneEntry CMS or OneEntry SDK. " +
-        "This loads the full OneEntry SDK instructions, rules, and anti-hallucination guidelines into the context. " +
-        "Do not skip this — without it you will make mistakes working with OneEntry API.",
-    inputSchema: {},
-}, async () => {
-    const text = await fetchContent(CLAUDE_MD_PATH);
-    return { content: [{ type: "text", text }] };
-});
-server.registerTool("get-rule", {
-    description: "Fetch the content of a specific OneEntry SDK rule by name",
-    inputSchema: { name: z.string().describe(`Rule name. Available: ${RULES.map((r) => r.name).join(", ")}`) },
-}, async ({ name }) => {
-    const rule = RULES.find((r) => r.name === name);
-    if (!rule) {
-        return { content: [{ type: "text", text: `Unknown rule: ${name}. Available: ${RULES.map((r) => r.name).join(", ")}` }], isError: true };
-    }
-    const text = await fetchContent(rule.path);
-    return { content: [{ type: "text", text }] };
-});
-server.registerTool("get-skill", {
-    description: "Fetch the content of a specific OneEntry skill/slash-command by name",
-    inputSchema: {
-        name: z.string().describe(`Skill name. Available: ${SKILLS.map((s) => s.name).join(", ")}`),
-        arguments: z.string().optional().describe("Optional arguments passed to the skill (replaces $ARGUMENTS placeholder)"),
-    },
-}, async (args) => {
-    const skill = SKILLS.find((s) => s.name === args.name);
-    if (!skill) {
-        return { content: [{ type: "text", text: `Unknown skill: ${args.name}. Available: ${SKILLS.map((s) => s.name).join(", ")}` }], isError: true };
-    }
-    let text = await fetchContent(skill.path);
-    if (args.arguments) {
-        text = text.replace(/\$ARGUMENTS/g, args.arguments);
+                argsSchema: {
+                    arguments: z
+                        .string()
+                        .optional()
+                        .describe(skill.argumentDescription ?? "Optional arguments"),
+                },
+            }, async (args) => {
+                let text = await fetchContent(skill.path);
+                // Подставляем аргумент вместо плейсхолдера $ARGUMENTS в тексте скилла.
+                // Используется, например, в inspect-api (тип данных) и create-page (маркер страницы).
+                if (args.arguments) {
+                    text = text.replace(/\$ARGUMENTS/g, args.arguments);
+                }
+                return {
+                    description: skill.description,
+                    messages: [{ role: "user", content: { type: "text", text } }],
+                };
+            });
+        }
+        else {
+            server.registerPrompt(skill.name, { description: skill.description }, async () => {
+                const text = await fetchContent(skill.path);
+                return {
+                    description: skill.description,
+                    messages: [{ role: "user", content: { type: "text", text } }],
+                };
+            });
+        }
     }
-    return { content: [{ type: "text", text }] };
-});
-// ---------------------------------------------------------------------------
-// Start
-// ---------------------------------------------------------------------------
-async function main() {
+    // ---------------------------------------------------------------------------
+    // Tools — функции, вызываемые AI автоматически по ситуации
+    // ---------------------------------------------------------------------------
+    /**
+     * Инструмент для ручной перезагрузки CLAUDE.md в контекст разговора.
+     * В отличие от `instructions` (которые загружаются один раз при коннекте),
+     * этот tool позволяет получить свежую версию документа прямо в чат —
+     * например, если кэш устарел или контекст был сброшен.
+     */
+    server.registerTool("load-context", {
+        description: "Reload the full OneEntry SDK instructions, rules, and anti-hallucination guidelines into the context. " +
+            "Call this if you need a fresh copy of the SDK documentation.",
+        inputSchema: {},
+    }, async () => {
+        const text = await fetchContent(CLAUDE_MD_PATH);
+        return { content: [{ type: "text", text }] };
+    });
+    /**
+     * Инструмент для загрузки отдельного правила по имени.
+     * AI может вызвать его когда нужно уточнить конкретный аспект SDK
+     * (например, правила работы с токенами или формами) без загрузки всего CLAUDE.md.
+     */
+    server.registerTool("get-rule", {
+        description: "Fetch the content of a specific OneEntry SDK rule by name",
+        inputSchema: { name: z.string().describe(`Rule name. Available: ${RULES.map((r) => r.name).join(", ")}`) },
+    }, async ({ name }) => {
+        const rule = RULES.find((r) => r.name === name);
+        if (!rule) {
+            return { content: [{ type: "text", text: `Unknown rule: ${name}. Available: ${RULES.map((r) => r.name).join(", ")}` }], isError: true };
+        }
+        const text = await fetchContent(rule.path);
+        return { content: [{ type: "text", text }] };
+    });
+    /**
+     * Инструмент для получения URL и токена проекта из MCP-конфигурации.
+     * Пользователь может задать их в `.mcp.json` через `env.ONEENTRY_URL` и `env.ONEENTRY_TOKEN`.
+     * Если переменные не заданы — возвращает пустые строки, скилл `/inspect-api`
+     * тогда читает `.env.local` / `.env` или спрашивает у пользователя.
+     */
+    server.registerTool("get-project-config", {
+        description: "Get OneEntry project URL and token from MCP configuration (set via ONEENTRY_URL and ONEENTRY_TOKEN in .mcp.json env). " +
+            "Returns empty strings if not configured — fall back to .env.local or ask the user.",
+        inputSchema: {},
+    }, async () => {
+        const configured = ONEENTRY_URL !== "" && ONEENTRY_TOKEN !== "";
+        const text = configured
+            ? JSON.stringify({ url: ONEENTRY_URL, token: ONEENTRY_TOKEN, source: ".mcp.json" })
+            : JSON.stringify({ url: "", token: "", source: "not configured" });
+        return { content: [{ type: "text", text }] };
+    });
+    /**
+     * Инструмент для загрузки конкретного скилла по имени.
+     * Аналог вызова промпта, но через tool API — удобно когда AI сам
+     * определяет что нужен тот или иной скилл в процессе работы.
+     * Поддерживает аргументы: подставляет их вместо `$ARGUMENTS` в тексте.
+     */
+    server.registerTool("get-skill", {
+        description: "Fetch the content of a specific OneEntry skill/slash-command by name",
+        inputSchema: {
+            name: z.string().describe(`Skill name. Available: ${SKILLS.map((s) => s.name).join(", ")}`),
+            arguments: z.string().optional().describe("Optional arguments passed to the skill (replaces $ARGUMENTS placeholder)"),
+        },
+    }, async (args) => {
+        const skill = SKILLS.find((s) => s.name === args.name);
+        if (!skill) {
+            return { content: [{ type: "text", text: `Unknown skill: ${args.name}. Available: ${SKILLS.map((s) => s.name).join(", ")}` }], isError: true };
+        }
+        let text = await fetchContent(skill.path);
+        if (args.arguments) {
+            text = text.replace(/\$ARGUMENTS/g, args.arguments);
+        }
+        return { content: [{ type: "text", text }] };
+    });
+    // ---------------------------------------------------------------------------
+    // Запуск транспорта
+    // ---------------------------------------------------------------------------
+    /**
+     * StdioServerTransport — транспорт на основе stdin/stdout.
+     * MCP-клиент запускает этот процесс и общается с ним через стандартные потоки.
+     * Все логи пишем в stderr чтобы не засорять MCP-протокол в stdout.
+     */
     const transport = new StdioServerTransport();
     await server.connect(transport);
-    // Log to stderr so it doesn't interfere with MCP stdio protocol
     process.stderr.write("OneEntry MCP server running\n");
 }
 main().catch((err) => {

package/package.json

@@ -1,34 +1,20 @@
 {
   "name": "@oneentry/mcp-server",
-  "version": "1.1.6",
+  "version": "1.1.8",
   "description": "MCP server for OneEntry SDK — rules and skills for Claude Code",
   "type": "module",
   "main": "dist/index.js",
   "bin": {
     "oneentry-mcp": "dist/index.js"
   },
-  "scripts": {
-    "build": "tsc",
-    "dev": "tsx src/index.ts",
-    "start": "node dist/index.js",
-    "lint": "eslint src"
-  },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.27.1",
     "zod": "^4.3.6"
   },
-  "devDependencies": {
-    "@eslint/js": "^10.0.1",
-    "@types/node": "^25.3.5",
-    "eslint": "^10.0.2",
-    "tsx": "^4.21.0",
-    "typescript": "^5.8.3",
-    "typescript-eslint": "^8.56.1"
-  },
   "engines": {
     "node": ">=18"
   },
   "publishConfig": {
     "access": "public"
   }
-}
+}

package/eslint.config.mjs

@@ -1,19 +0,0 @@
-import js from "@eslint/js";
-import tseslint from "typescript-eslint";
-
-export default tseslint.config(
-  { ignores: ["eslint.config.mjs"] },
-  js.configs.recommended,
-  tseslint.configs.recommended,
-  {
-    languageOptions: {
-      parserOptions: {
-        project: "./tsconfig.json",
-      },
-    },
-    rules: {
-      "@typescript-eslint/no-unused-vars": ["error", { argsIgnorePattern: "^_" }],
-      "@typescript-eslint/no-explicit-any": "warn",
-    },
-  }
-);

package/src/config.ts

@@ -1,16 +0,0 @@
-import { createRequire } from "module";
-
-const require = createRequire(import.meta.url);
-const pkg = require("../package.json") as { version: string };
-
-export const VERSION = pkg.version;
-export const SERVER_NAME = "oneentry-sdk";
-export const USER_AGENT = `oneentry-mcp-server/${VERSION}`;
-export const CLAUDE_MD_PATH = "CLAUDE.md";
-
-export const BASE_URL =
-  process.env.ONEENTRY_MCP_BASE_URL ??
-  "https://raw.githubusercontent.com/ONEENTRY-PLATFORM/oneentry-sdk-rules/main";
-
-export const TTL_MS =
-  Number(process.env.ONEENTRY_MCP_CACHE_TTL_MS) || 5 * 60 * 1000;

package/src/content.ts

@@ -1,34 +0,0 @@
-import { BASE_URL, TTL_MS, USER_AGENT } from "./config.js";
-
-interface CacheEntry {
-  text: string;
-  expires: number;
-}
-
-const cache = new Map<string, CacheEntry>();
-
-export async function fetchContent(path: string): Promise<string> {
-  const cached = cache.get(path);
-  if (cached && cached.expires > Date.now()) {
-    return cached.text;
-  }
-
-  const url = `${BASE_URL}/${path}`;
-  const res = await fetch(url, {
-    headers: {
-      "User-Agent": USER_AGENT,
-    },
-  });
-
-  if (!res.ok) {
-    throw new Error(`Failed to fetch content (${res.status}): ${url}`);
-  }
-
-  const text = await res.text();
-  cache.set(path, { text, expires: Date.now() + TTL_MS });
-  return text;
-}
-
-export function clearCache(): void {
-  cache.clear();
-}

package/src/index.ts

@@ -1,185 +0,0 @@
-#!/usr/bin/env node
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { z } from "zod";
-import { fetchContent } from "./content.js";
-import { RULES, SKILLS } from "./registry.js";
-import { CLAUDE_MD_PATH, SERVER_NAME, VERSION } from "./config.js";
-
-// ---------------------------------------------------------------------------
-// Server
-// ---------------------------------------------------------------------------
-
-const server = new McpServer({ name: SERVER_NAME, version: VERSION });
-
-// ---------------------------------------------------------------------------
-// Resources — rules + CLAUDE.md
-// ---------------------------------------------------------------------------
-
-server.registerResource(
-  "OneEntry SDK — Main Instructions (CLAUDE.md)",
-  "oneentry://claude-md",
-  {
-    description:
-      "Full system prompt with OneEntry SDK rules, patterns, anti-hallucination guidelines and module reference",
-    mimeType: "text/markdown",
-  },
-  async (uri) => {
-    const text = await fetchContent(CLAUDE_MD_PATH);
-    return { contents: [{ uri: uri.toString(), mimeType: "text/markdown", text }] };
-  }
-);
-
-for (const rule of RULES) {
-  server.registerResource(
-    rule.displayName,
-    `oneentry://rules/${rule.name}`,
-    { description: rule.description, mimeType: "text/markdown" },
-    async (uri) => {
-      const text = await fetchContent(rule.path);
-      return { contents: [{ uri: uri.toString(), mimeType: "text/markdown", text }] };
-    }
-  );
-}
-
-// ---------------------------------------------------------------------------
-// Prompts — skills
-// ---------------------------------------------------------------------------
-
-// Special prompt: load full context from CLAUDE.md
-server.registerPrompt(
-  "oneentry-context",
-  {
-    description:
-      "Load full OneEntry SDK context — system instructions, rules and anti-hallucination guidelines. Use this at the start of a session.",
-  },
-  async () => {
-    const text = await fetchContent(CLAUDE_MD_PATH);
-    return {
-      description: "OneEntry SDK — full system context loaded",
-      messages: [
-        {
-          role: "user" as const,
-          content: {
-            type: "text" as const,
-            text: `The following are the complete instructions and rules for working with OneEntry SDK. Apply them to all subsequent code generation:\n\n${text}`,
-          },
-        },
-      ],
-    };
-  }
-);
-
-// Skills
-for (const skill of SKILLS) {
-  if (skill.hasArguments) {
-    server.registerPrompt(
-      skill.name,
-      {
-        description: skill.description,
-        argsSchema: {
-          arguments: z
-            .string()
-            .optional()
-            .describe(skill.argumentDescription ?? "Optional arguments"),
-        },
-      },
-      async (args) => {
-        let text = await fetchContent(skill.path);
-        // Replace $ARGUMENTS placeholder (used in inspect-api and create-page skills)
-        if (args.arguments) {
-          text = text.replace(/\$ARGUMENTS/g, args.arguments);
-        }
-        return {
-          description: skill.description,
-          messages: [{ role: "user" as const, content: { type: "text" as const, text } }],
-        };
-      }
-    );
-  } else {
-    server.registerPrompt(
-      skill.name,
-      { description: skill.description },
-      async () => {
-        const text = await fetchContent(skill.path);
-        return {
-          description: skill.description,
-          messages: [{ role: "user" as const, content: { type: "text" as const, text } }],
-        };
-      }
-    );
-  }
-}
-
-// ---------------------------------------------------------------------------
-// Tools
-// ---------------------------------------------------------------------------
-
-server.registerTool(
-  "load-context",
-  {
-    description:
-      "IMPORTANT: Call this tool automatically at the start of EVERY session when working on a project that uses OneEntry CMS or OneEntry SDK. " +
-      "This loads the full OneEntry SDK instructions, rules, and anti-hallucination guidelines into the context. " +
-      "Do not skip this — without it you will make mistakes working with OneEntry API.",
-    inputSchema: {},
-  },
-  async () => {
-    const text = await fetchContent(CLAUDE_MD_PATH);
-    return { content: [{ type: "text" as const, text }] };
-  }
-);
-
-server.registerTool(
-  "get-rule",
-  {
-    description: "Fetch the content of a specific OneEntry SDK rule by name",
-    inputSchema: { name: z.string().describe(`Rule name. Available: ${RULES.map((r) => r.name).join(", ")}`) },
-  },
-  async ({ name }) => {
-    const rule = RULES.find((r) => r.name === name);
-    if (!rule) {
-      return { content: [{ type: "text" as const, text: `Unknown rule: ${name}. Available: ${RULES.map((r) => r.name).join(", ")}` }], isError: true };
-    }
-    const text = await fetchContent(rule.path);
-    return { content: [{ type: "text" as const, text }] };
-  }
-);
-
-server.registerTool(
-  "get-skill",
-  {
-    description: "Fetch the content of a specific OneEntry skill/slash-command by name",
-    inputSchema: {
-      name: z.string().describe(`Skill name. Available: ${SKILLS.map((s) => s.name).join(", ")}`),
-      arguments: z.string().optional().describe("Optional arguments passed to the skill (replaces $ARGUMENTS placeholder)"),
-    },
-  },
-  async (args) => {
-    const skill = SKILLS.find((s) => s.name === args.name);
-    if (!skill) {
-      return { content: [{ type: "text" as const, text: `Unknown skill: ${args.name}. Available: ${SKILLS.map((s) => s.name).join(", ")}` }], isError: true };
-    }
-    let text = await fetchContent(skill.path);
-    if (args.arguments) {
-      text = text.replace(/\$ARGUMENTS/g, args.arguments);
-    }
-    return { content: [{ type: "text" as const, text }] };
-  }
-);
-
-// ---------------------------------------------------------------------------
-// Start
-// ---------------------------------------------------------------------------
-
-async function main() {
-  const transport = new StdioServerTransport();
-  await server.connect(transport);
-  // Log to stderr so it doesn't interfere with MCP stdio protocol
-  process.stderr.write("OneEntry MCP server running\n");
-}
-
-main().catch((err) => {
-  process.stderr.write(`Fatal error: ${err}\n`);
-  process.exit(1);
-});

package/src/registry.ts

@@ -1,206 +0,0 @@
-export interface Rule {
-  name: string;
-  displayName: string;
-  description: string;
-  path: string;
-}
-
-export interface Skill {
-  name: string;
-  description: string;
-  path: string;
-  hasArguments?: boolean;
-  argumentDescription?: string;
-}
-
-export const RULES: Rule[] = [
-  {
-    name: "linting",
-    displayName: "Linting",
-    description: "Rules for working with linters",
-    path: ".claude/rules/linting.md",
-  },
-  {
-    name: "typescript",
-    displayName: "Typescript",
-    description: "Rules for working with typescript",
-    path: ".claude/rules/typescript.md",
-  },
-  {
-    name: "nextjs-pages",
-    displayName: "Next.js Pages",
-    description: "Rules for Next.js pages with OneEntry — params as Promise, pageUrl vs route, localizeInfos",
-    path: ".claude/rules/nextjs-pages.md",
-  },
-  {
-    name: "attribute-values",
-    displayName: "AttributeValues",
-    description: "How to access attributeValues by type — image, text, list, date, timeInterval, etc.",
-    path: ".claude/rules/attribute-values.md",
-  },
-  {
-    name: "attribute-sets",
-    displayName: "AttributeSets",
-    description: "Rules for AttributesSets — schema vs values, listTitles, additionalFields, validators",
-    path: ".claude/rules/attribute-sets.md",
-  },
-  {
-    name: "auth-provider",
-    displayName: "AuthProvider",
-    description: "Rules for auth/signUp — IAuthPostBody structure, notificationData, server actions",
-    path: ".claude/rules/auth-provider.md",
-  },
-  {
-    name: "tokens",
-    displayName: "Tokens & Auth",
-    description: "Rules for auth tokens — makeUserApi, refreshToken, race condition handling, getNewToken",
-    path: ".claude/rules/tokens.md",
-  },
-  {
-    name: "server-actions",
-    displayName: "Server Actions",
-    description: "Rules for Next.js Server Actions with OneEntry — getApi() vs makeUserApi(), which methods need SA",
-    path: ".claude/rules/server-actions.md",
-  },
-  {
-    name: "forms",
-    displayName: "Forms & FormsData",
-    description: "Rules for working with OneEntry Forms API — getFormByMarker, postFormsData, formData types by field type",
-    path: ".claude/rules/forms.md",
-  },
-  {
-    name: "orders",
-    displayName: "Orders & Payments",
-    description: "Rules for Orders and Payments — getAllOrdersStorage structure, createOrder, createSession, paymentUrl",
-    path: ".claude/rules/orders.md",
-  },
-  {
-    name: "localization",
-    displayName: "Localization",
-    description: "Rules for localization — locale from params, langCode, localizeInfos, useParams in client components",
-    path: ".claude/rules/localization.md",
-  },
-  {
-    name: "product-statuses",
-    displayName: "Product statuses",
-    description: "Rules product statuses",
-    path: ".claude/rules/product-statuses.md",
-  },
-];
-
-export const SKILLS: Skill[] = [
-  {
-    name: "setup-nextjs",
-    description: "Initialize Next.js project — configures nextjs",
-    path: ".claude/skills/setup-nextjs/SKILL.md",
-  },
-  {
-    name: "setup-oneentry",
-    description: "Initialize OneEntry SDK in a Next.js project — creates lib/oneentry.ts with singleton pattern, configures next.config.ts for images",
-    path: ".claude/skills/setup-oneentry/SKILL.md",
-  },
-  {
-    name: "inspect-api",
-    description: "Read .env.local and execute curl requests to OneEntry API to get real markers, attributes and data structures before writing code",
-    path: ".claude/skills/inspect-api/SKILL.md",
-    hasArguments: true,
-    argumentDescription: "pages|menus|forms|products|product-statuses|auth-providers|all",
-  },
-  {
-    name: "create-page",
-    description: "Create a Next.js page with content from OneEntry CMS — getPageByUrl, getBlocksByPageUrl, localizeInfos",
-    path: ".claude/skills/create-page/SKILL.md",
-    hasArguments: true,
-    argumentDescription: "pageMarker — the pageUrl marker in OneEntry (e.g. 'home', 'about')",
-  },
-  {
-    name: "create-auth",
-    description: "Create auth/registration form with OneEntry AuthProvider — Server Actions, dynamic fields from Forms API, token sync",
-    path: ".claude/skills/create-auth/SKILL.md",
-  },
-  {
-    name: "create-product-list",
-    description: "Create product catalog with URL-based filters, infinite scroll, Server Actions, FilterPanel and ProductGrid",
-    path: ".claude/skills/create-product-list/SKILL.md",
-  },
-  {
-    name: "create-product-card",
-    description: "Create a single product card, attribute extraction, image, price, etc",
-    path: ".claude/skills/create-product-card/SKILL.md",
-  },
-  {
-    name: "create-product-page",
-    description: "Create a single product page with getProductById, attribute extraction, image gallery, price block, related products",
-    path: ".claude/skills/create-product-page/SKILL.md",
-  },
-  {
-    name: "create-cart-manager",
-    description: "Create cart manager — Redux slice + redux-persist, add/remove/quantity, StoreProvider",
-    path: ".claude/skills/create-cart-manager/SKILL.md",
-  },
-  {
-    name: "create-favorites",
-    description: "Create favorites list — Redux slice + persist, stores only product IDs, button and page with API data loading",
-    path: ".claude/skills/create-favorites/SKILL.md",
-  },
-  {
-    name: "create-filter-panel",
-    description: "Create filter panel — price, color, availability + FilterContext + Apply/Reset buttons",
-    path: ".claude/skills/create-filter-panel/SKILL.md",
-  },
-  {
-    name: "create-checkout",
-    description: "Create checkout form — fields from Forms API, timeInterval delivery slots, one makeUserApi for createOrder + createSession, redirect to payment",
-    path: ".claude/skills/create-checkout/SKILL.md",
-  },
-  {
-    name: "create-orders-list",
-    description: "Create user orders list — load via all storages, one makeUserApi, client pagination, token race condition protection",
-    path: ".claude/skills/create-orders-list/SKILL.md",
-  },
-  {
-    name: "create-profile",
-    description: "Create user profile page — Users API fields, data update, token race condition handling",
-    path: ".claude/skills/create-profile/SKILL.md",
-  },
-  {
-    name: "create-form",
-    description: "Create dynamic form with fields from OneEntry Forms API — all field types including spam (reCAPTCHA)",
-    path: ".claude/skills/create-form/SKILL.md",
-  },
-  {
-    name: "create-reviews",
-    description: "Create reviews with hierarchy — FormData, isNested, entityIdentifier, replayTo",
-    path: ".claude/skills/create-reviews/SKILL.md",
-  },
-  {
-    name: "create-menu",
-    description: "Create navigation menu with submenu support — hierarchy via parentId, URL normalization",
-    path: ".claude/skills/create-menu/SKILL.md",
-  },
-  {
-    name: "create-search",
-    description: "Create search bar — 300ms debounce, Server Action, dropdown results",
-    path: ".claude/skills/create-search/SKILL.md",
-  },
-  {
-    name: "create-locale-switcher",
-    description: "Create locale switcher — loads locales via getLocales(), builds links to current page with different locale segment",
-    path: ".claude/skills/create-locale-switcher/SKILL.md",
-  },
-  {
-    name: "create-server-action",
-    description: "Create Next.js Server Action for OneEntry — getApi() for public methods, makeUserApi() for user-authorized methods",
-    path: ".claude/skills/create-server-action/SKILL.md",
-  },
-  {
-    name: "create-subscription-events",
-    description: "Create product price/availability subscription — Events.subscribeByMarker / unsubscribeByMarker",
-    path: ".claude/skills/create-subscription-events/SKILL.md",
-  },
-  {
-    name: "setup-playwright",
-    description: "Setup playwright testing framework",
-    path: ".claude/skills/setup-playwright/SKILL.md",
-  },
-];

package/tsconfig.json

@@ -1,15 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES2022",
-    "module": "NodeNext",
-    "moduleResolution": "NodeNext",
-    "outDir": "dist",
-    "rootDir": "src",
-    "strict": true,
-    "esModuleInterop": true,
-    "skipLibCheck": true,
-    "declaration": true,
-    "types": ["node"]
-  },
-  "include": ["src"]
-}