К основному содержанию
правило CX Codex

mcp-typescript — правило для Claude Code: что делает и как установить

Задаёт ограничения для разработки MCP-сервера на TypeScript: вывод логов только в stderr, проверка типов и защита от опасных действий.

MIT ★ 1 198 обновлён 2026-10-23

Установить в Claude Code · Вручную: положить файлы Все способы и платформы ↓
.claude/rules/mcp-typescript.md
Открыть на GitHub

Что делает 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 и 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

Похожие правила IDE

Все правила IDE по теме «Настройка агента: память, контекст, субагенты» →
mcp-specialist coco-research Субагент mcp-specialist для разработки и настройки MCP-серверов в Claude Code. Помогает спроектировать архитектуру, реализовать транспортный слой, настроить инструменты и ресурсы, отладить подключения по спецификации MCP 2025-06-18. CX Codex ★ 328звёзд репо mcp-server-architect davila7 Субагент mcp-server-architect для Claude Code проектирует MCP-серверы и помогает реализовать их транспорт и инструменты. Подключается к задачам по архитектуре и соблюдению протокола. CX Codex 1 649установок mcp-developer https://github.com/Jeffallan Скилл mcp-developer для сборки и отладки MCP-серверов и клиентов на TypeScript или Python: схемы инструментов, транспорт, проверка протокола в инспекторе. CX Codex +1 4 600установок MCP Protocol Conformance studiomeyer-io Сервер MCP Protocol Conformance проверяет MCP-серверы на соответствие протоколу: от JSON-RPC и схем инструментов до OAuth 2.1 PKCE. Пригодится перед выпуском или проверкой изменений. CX Codex +1 typescript-security-review giuseppe-trisciuoglio Скилл typescript-security-review проверяет код TypeScript и Node.js на уязвимости OWASP, утечки секретов и ошибки в настройке JWT или CORS. Пригодится перед релизом или при аудите авторизации в Express, NestJS и Next.js. CX Codex +1 4 200установок typescript-security-expert Giuseppe Trisciuoglio Субагент typescript-security-expert для Claude Code проверяет безопасность приложений на TypeScript и Node.js. Подключается к аудитам, моделированию угроз и внедрению DevSecOps. CX Codex ★ 372звёзд репо

Из того же набора155

Весь набор →
frontend-react Правило frontend-react для React-фронтенда: держит правки интерфейса узкими — явные типы пропсов, готовые паттерны состояний, маршруты без переделки. CX Codex +1 ★ 1 198звёзд репо platform-admin Субагент platform-admin управляет настройками, хуками, импортом, резервными копиями и MCP в Claude Code Agent Monitor. Проверяет изменения через дашборд. CX Codex ★ 1 198звёзд репо frontend-reviewer Субагент Claude Code frontend-reviewer проверяет изменения в React-интерфейсе на поломки поведения, рассинхрон состояния и ошибки UX. Проводит ревью UI после правок. CX Codex ★ 1 198звёзд репо platform-status Команда platform-status прогоняет диагностику CCAM: хуки, корни конфигов, версия дашборда, готовность MCP-сборки. Ничего не меняет. CX Codex +1 ★ 1 198звёзд репо run-operator Субагент run-operator управляет процессами Claude Code и Codex через CCAM: перед запуском проверяет параметры и показывает их пользователю. CX Codex ★ 1 198звёзд репо mcp-reviewer Субагент mcp-reviewer проверяет изменения в MCP-серверах: схемы инструментов, защиту разрушительных операций, обработку ошибок и корректность stdio. Пригодится перед мержем правок в сервер. CX Codex ★ 1 198звёзд репо backend-node Правило backend-node для Claude Code содержит инструкции по работе с серверными скриптами Node.js и обработчиками хуков. Помогает сохранять совместимость API и целостность базы данных. CX Codex +1 ★ 1 198звёзд репо report Команда report для Claude Code формирует отчёты CCAM по затратам, надёжности, рабочим процессам или для руководства. Тип отчёта и область данных задаются в запросе. CX Codex +1 ★ 1 198звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой