mcp-typescript — правило для Claude Code: что делает и как установить
Задаёт ограничения для разработки MCP-сервера на TypeScript: вывод логов только в stderr, проверка типов и защита от опасных действий.
MIT ★ 1 198 обновлён 2026-10-23
.claude/rules/mcp-typescript.mdЧто делает mcp-typescript
Правило следит за файлами в каталоге mcp/: исходниками TypeScript, конфигурациями tsconfig.json, package.json, окружением .env.example и документацией.
Оно запрещает писать логи в stdout, чтобы не ломать протокол MCP. Все сообщения журнала должны идти строго в stderr. Имена инструментов остаются понятными и стабильными, схемы входных параметров ограничиваются, а опасные операции прячутся за явными подтверждениями. По умолчанию вызовы API разрешены только на loopback-интерфейсы.
После любых правок кода сервер обязательно проверяется командами npm run mcp:typecheck и npm run mcp:build. Вывод в stdout ломает протокольный обмен MCP.
Какие задачи решает
- предотвратить сбой протокола MCP из-за случайного вывода логов в stdout
- ограничить схемы входных параметров для MCP-инструментов
- защитить опасные действия MCP-сервера явными проверками
- запускать сборку и проверку типов через npm run mcp:typecheck и mcp:build
Примеры запросов агенту
- Добавь новый MCP-инструмент для чтения файлов в mcp/src/
- Проверь TypeScript-код MCP-сервера перед коммитом
- Настрой логирование ошибок в mcp/src/index.ts
Как установить mcp-typescript
Вручную: положить файлы
.claude/rules/mcp-typescript.mdПоле paths во frontmatter ограничивает файлы
AGENTS.md
Codex читает AGENTS.md: вставьте текст правила туда
Вручную: положить файлы
.cursor/rules/mcp-typescript.mdcВо frontmatter: description, globs, alwaysApply
Вручную: положить файлы
.github/instructions/mcp-typescript.instructions.mdПоле applyTo задаёт, к каким файлам применять
Вручную: положить файлы
.devin/rules/mcp-typescript.mdВручную: положить файлы
.clinerules/mcp-typescript.mdПо шагам, с командами для каждой платформы: AGENTS.md и CLAUDE.md: что это, кто читает и какой выбрать
Вопросы о mcp-typescript
Как установить mcp-typescript в Claude Code?
Сохраните файл правила по пути .claude/rules/mcp-typescript.md в корне вашего проекта.
Что делает правило mcp-typescript?
Оно задаёт стандарты для MCP-сервера: изолирует логи в stderr, требует строгие схемы ввода, защищает деструктивные операции и обязывает запускать тайпчек со сборкой.
Почему правило запрещает писать логи в stdout?
Протокол MCP использует stdout для обмена сообщениями. Посторонний текст в stdout нарушит передачу данных между клиентом и сервером.
Исходный текст
mcp-typescript.md · MIT
--- paths: - "mcp/src/**/*.ts" - "mcp/package.json" - "mcp/tsconfig.json" - "mcp/.env.example" - "mcp/README.md" --- # MCP Server Rules - Keep MCP tool names stable and descriptive. - Keep destructive operations behind explicit guardrails. - Route all logs to stderr only; never write protocol logs to stdout. - Keep tool input schemas strict and bounded. - Preserve loopback-only API target enforcement unless security posture changes by request. - Verify MCP with `npm run mcp:typecheck` and `npm run mcp:build` after code edits.
© hoangsonww · MIT · hoangsonww/Claude-Code-Agent-Monitor