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

create-mcp-servers — скилл для Claude Code

Скилл create-mcp-servers помогает создавать MCP-серверы на Python и TypeScript для Claude Code и Claude Desktop с нуля или обновлять существующие.

MIT ★ 1 988 обновлён 2026-04-01

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add glittercowboy/taches-cc-resources
/plugin install taches-cc-resources@taches-cc-resources
Открыть на GitHub

Что делает create-mcp-servers

Скилл содержит пошаговые сценарии для проектирования серверов Model Context Protocol. Он делит архитектуру по числу операций: если их одна или две, предлагает плоский набор инструментов, а если три и более — схему динамического обнаружения через четыре мета-инструмента и файл operations.json.

Внутри заложены готовые скрипты инициализации окружения, шаблоны серверов и справочники по авторизации OAuth. Для Python скилл опирается на пакетный менеджер uv и виртуальные окружения, а секреты требует передавать строго через переменные среды в конфигурациях ~/.zshrc.

Без абсолютных путей к исполняемым файлам вроде node или uv сервер в stdio завершится с ошибкой command not found.

Какие задачи решает

  • Создать MCP-сервер на Python или TypeScript с нуля
  • Спроектировать динамическое обнаружение инструментов для крупного API
  • Настроить подключение сервера к Claude Code без открытых токенов в чате
  • Диагностировать сбои запуска и ошибки stdio-транспорта в MCP

Примеры запросов агенту

  • Создай новый MCP-сервер на Python для работы с локальной базой SQLite
  • Помоги добавить OAuth-авторизацию в существующий MCP-сервер
  • Проверь конфигурацию claude mcp list и найди причину сбоя подключения

Как установить create-mcp-servers

1Через маркетплейс плагинов

/plugin marketplace add glittercowboy/taches-cc-resources
/plugin install taches-cc-resources@taches-cc-resources

Команда ставит плагин taches-cc-resources целиком, со всеми его скиллами

2Через Skills CLI (Vercel)

npx skills add glittercowboy/taches-cc-resources --skill create-mcp-servers -a claude-code

3Вручную: положить файлы

~/.claude/skills/create-mcp-servers/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/create-mcp-servers/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о create-mcp-servers

Как установить create-mcp-servers в Claude Code?

Выполните две команды по очереди: сначала /plugin marketplace add glittercowboy/taches-cc-resources, затем /plugin install taches-cc-resources@taches-cc-resources.

Что делает create-mcp-servers?

Скилл направляет агента по шагам создания MCP-сервера, создаёт структуру проекта для Python или TypeScript и готовит конфигурацию подключения.

Чем отличается архитектура для простых и больших API?

Для одной или двух операций генерируются отдельные инструменты. При трёх операциях и более применяется схема обнаружения с четырьмя мета-инструментами и картой operations.json, чтобы экономить контекст.

Исходный текст

SKILL.md · MIT
---
name: create-mcp-servers
description: Create Model Context Protocol (MCP) servers that expose tools, resources, and prompts to Claude. Use when building custom integrations, APIs, data sources, or any server that Claude should interact with via the MCP protocol. Supports both TypeScript and Python implementations.
---

<objective>
MCP servers extend Claude's capabilities by exposing tools, resources, and prompts. This skill guides creation of production-ready MCP servers with API integrations, OAuth authentication, response optimization, and proper installation in Claude Code and Claude Desktop.
</objective>

<essential_principles>

<the_5_rules>
Every MCP server must follow these:

1. **Never Hardcode Secrets** - Use `${VAR}` expansion in configs, environment variables in code
2. **Use `cwd` Property** - Isolates dependencies (not `--cwd` in args)
3. **Always Absolute Paths** - `which uv` to find paths, never relative
4. **One Server Per Directory** - `~/Developer/mcp/{server-name}/`
5. **Use `uv` for Python** - Better than pip, handles venvs automatically
</the_5_rules>

<security_checklist>
- Never ask user to paste secrets into chat
- Always use environment variables for credentials
- Use ${VAR} expansion in configs
- Provide exact commands for user to run in terminal
- Verify environment variable existence without showing values
- Never hardcode API keys in code or configs
</security_checklist>

<architecture_decision>
Operation count determines architecture:

- **1-2 operations** → Traditional pattern (flat tools)
- **3+ operations** → On-demand discovery pattern (meta-tools)

Traditional: Each operation is a separate tool
On-demand: 4 meta-tools (discover, get_schema, execute, continue) + operations.json
</architecture_decision>

<context>
MCP servers expose:
- **Tools**: Functions Claude can call (API requests, file operations, calculations)
- **Resources**: Data Claude can read (files, database records, API responses)
- **Prompts**: Reusable prompt templates with arguments

Standard location: `~/Developer/mcp/{server-name}/`
</context>

</essential_principles>

<routing>
Based on user intent, route to appropriate workflow:

**No context provided** (skill invoked without description):
Use AskUserQuestion:
- header: "Mode"
- question: "What would you like to do?"
- options:
  - "Create a new MCP server" → workflows/create-new-server.md
  - "Update an existing MCP server" → workflows/update-existing-server.md
  - "Troubleshoot a server" → workflows/troubleshoot-server.md

**Context provided** (user described what they want):
Route directly to workflows/create-new-server.md
</routing>

<workflows_index>
| Workflow | Purpose |
|----------|---------|
| create-new-server.md | Full 8-step workflow from intake to verification |
| update-existing-server.md | Modify or extend an existing server |
| troubleshoot-server.md | Diagnose and fix connection/runtime issues |
</workflows_index>

<templates_index>
| Template | Purpose |
|----------|---------|
| python-server.py | Traditional pattern starter for Python |
| typescript-server.ts | Traditional pattern starter for TypeScript |
| operations.json | On-demand discovery operations definition |
</templates_index>

<scripts_index>
| Script | Purpose |
|--------|---------|
| setup-python-project.sh | Initialize Python MCP project with uv |
| setup-typescript-project.sh | Initialize TypeScript MCP project with npm |
</scripts_index>

<references_index>
**Core workflow:**
- creation-workflow.md - Complete step-by-step with exact commands

**Architecture patterns:**
- traditional-pattern.md - For 1-2 operations (flat tools)
- large-api-pattern.md - For 3+ operations (on-demand discovery)

**Language-specific:**
- python-implementation.md - Async patterns, type hints
- typescript-implementation.md - Type safety, SDK features

**Advanced topics:**
- oauth-implementation.md - OAuth with stdio isolation
- response-optimization.md - Field truncation, pagination
- tools-and-resources.md - Resources API, prompts, streaming
- testing-and-deployment.md - Unit tests, packaging, publishing
- validation-checkpoints.md - All validation checks
- adaptive-questioning-guide.md - Question templates for intake
- api-research-template.md - API research document format
</references_index>

<quick_reference>
```bash
# List servers
claude mcp list

# Add server (Python)
claude mcp add --transport stdio <name> \
  --env API_KEY='${API_KEY}' \
  -- uv --directory ~/Developer/mcp/<name> run python -m src.server

# Add server (TypeScript)
claude mcp add --transport stdio <name> \
  --env API_KEY='${API_KEY}' \
  -- node ~/Developer/mcp/<name>/build/index.js

# Remove server
claude mcp remove <name>

# Check logs
tail -f ~/Library/Logs/Claude/mcp-server-<name>.log

# Find paths
which uv && which node && which python
```
</quick_reference>

<troubleshooting_quick>
**Server not appearing:** Check `claude mcp list`, verify config in `~/.claude/settings.json`

**"command not found":** Use absolute paths from `which uv` / `which node`

**Environment variable not found:**
```bash
echo $MY_API_KEY  # Check if set
echo 'export MY_API_KEY="value"' >> ~/.zshrc && source ~/.zshrc
```

**Secrets visible in conversation:** STOP. Delete conversation. Rotate credentials. Never paste secrets in chat.

Full troubleshooting: workflows/troubleshoot-server.md
</troubleshooting_quick>

<success_criteria>
A production-ready MCP server has:
- Valid configuration in Claude Code (`claude mcp list` shows ✓ Connected)
- Valid configuration in Claude Desktop config
- Environment variables set securely in ~/.zshrc
- Architecture matches operation count
- OAuth stdio isolation if applicable
- Response optimization for list/search operations
- All validation checkpoints passed
- No errors in logs
</success_criteria>

© Lex Christopherson · MIT · glittercowboy/taches-cc-resources

Похожие скиллы

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
create-icp-tiers tomgranot Скилл create-icp-tiers сегментирует компании в HubSpot по отраслям и размеру штата. Создаёт выпадающее свойство через API и готовит логику для четырёх воркфлоу. CX Codex +1 ★ 81звёзд репо convex-create-component convex Скилл convex-create-component для Claude Code и Codex создаёт переиспользуемые Convex-компоненты с изолированными таблицами и чётким API. Выделяет backend-логику в отдельный модуль, владеющий своими данными. CX Codex +1 138 900установок create-auth better-auth Скилл create-auth проводит агента через планирование и настройку аутентификации в TypeScript/JavaScript-проекте на Better Auth: от сканирования кода до страниц входа. CX Codex +1 15 300установок python-mcp-server-generator официальный github Скилл python-mcp-server-generator создаёт Python MCP-серверы для подключения функций, API или базы данных к ИИ-клиентам. Подходит, когда нужен новый сервер на MCP Python SDK v2. CX Codex +1 10 418установок modern-python trailofbits Скилл modern-python для Claude Code настраивает Python-проекты с uv, ruff и ty; применяется при создании проектов, написании скриптов и миграции со старых инструментов. CX Codex +1 9 700установок local-dev modelcontextprotocol Скилл local-dev для Claude Code помогает собрать и запустить MCP-сервер из локального checkout. Включается при настройке локального запуска, подключении клиента или поиске причины, почему виден старый код. CX Codex +1 ★ 92 149звёзд репо

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

Весь набор →
landscape Команда landscape для Claude Code, которая картирует пространство домена: выявляет ключевых игроков, существующие инструменты, тренды и пробелы. Запускается с названием домена или в контексте текущей темы. CX Codex +1 ★ 1 988звёзд репо build-iphone-apps Скилл build-iphone-apps создаёт нативные приложения для iPhone на Swift через интерфейс командной строки без запуска Xcode. Ведёт разработку от макета до релиза в App Store. CX Codex +1 ★ 1 988звёзд репо run-prompt Команда run-prompt для Claude Code передаёт промпты из ./prompts/ субагентам по одному, последовательно или параллельно, для запуска независимых задач в отдельных контекстах. CX Codex +1 ★ 1 988звёзд репо open-source Ищет open-source библиотеки и инструменты под вашу задачу, проверяет, жив ли проект, и говорит, брать готовое или писать своё. CX Codex +1 ★ 1 988звёзд репо slash-command-auditor Субагент slash-command-auditor аудирует .md-файлы слэш-команд Claude Code по структуре, аргументам, контексту, инструментам и безопасности. CX Codex ★ 1 988звёзд репо create-hooks Скилл create-hooks учит писать и настраивать хуки Claude Code: от блокировки опасных команд до автоформатирования после правок. CX Codex +1 ★ 1 988звёзд репо subagent-auditor Субагент subagent-auditor проверяет конфигурационные файлы субагентов Claude Code на соответствие лучшим практикам. Находит ошибки в структуре XML, лишние права инструментов и слабые описания ролей. CX Codex ★ 1 988звёзд репо create-subagents Скилл create-subagents для Claude Code объясняет, как создавать субагентов, настраивать их инструменты и поручать им задачи через Task. Разделяет работу между агентами. CX Codex +1 ★ 1 988звёзд репо

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

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