erickwendel-contributions-mcp

Сервер протокола контекста моделей (MCP), предоставляющий инструменты для запроса информации о вкладе Эрика Венделя на различных платформах. Запрашивайте выступления, публикации в блогах и видео с помощью естественного языка через Claude, Cursor или аналогичные инструменты. Этот проект был создан с использованием IDE Cursor с агентом по умолчанию (пробная версия).

Быстрый старт

Используйте этот MCP-сервер напрямую с Claude Desktop или Cursor без установки:

{
  "mcpServers": {
    "erickwendel-contributions": {
      "command": "npx",
      "args": ["-y", "@erickwendel/contributions-mcp"]
    }
  }
}

Добавьте эту конфигурацию в:

• Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS)

• Cursor: ~/.cursor/mcp.json

Related MCP server: mintlify-mcp

Доступные инструменты

Этот MCP-сервер предоставляет следующие возможности:

Инструменты

• get-talks: Получает список выступлений с разбивкой на страницы и возможностью фильтрации

  • Поддерживает фильтрацию по ID, названию, языку, городу, стране и году

  • Может возвращать количество, сгруппированное по языку, стране или городу

• get-posts: Получает публикации с возможностью фильтрации и разбивки на страницы

  • Поддерживает фильтрацию по ID, названию, языку и порталу

• get-videos: Получает видео с возможностью фильтрации и разбивки на страницы

  • Поддерживает фильтрацию по ID, названию и языку

• check-status: Проверяет, работает ли API и отвечает ли он

Промпты

• find-content: Генерирует запросы для поиска конкретного контента по типу, теме и языку

• summarize-activity: Создает сводки активности контента по годам

Ресурсы

• erickwendel://about: Информация о сервере и метаданные возможностей

• erickwendel://statistics: Статистика контента и доступные запросы

Интеграция с ИИ-инструментами

Проверка возможностей MCP-сервера

Вы можете проверить возможности этого MCP-сервера с помощью MCP Inspector:

npm run inspect

Это покажет вам все доступные инструменты, их параметры и способы их использования.

Настройка

1. Убедитесь, что вы используете Node.js v20+

node -v
# v20.x.x or higher

2. Клонируйте этот репозиторий:

git clone https://github.com/erickwendel/erickwendel-contributions-mcp.git
cd erickwendel-contributions-mcp

3. Установите зависимости:

npm ci

4. Запустите сервер:

npm start

Интеграция с ИИ-инструментами

Настройка Cursor

Добавьте следующую конфигурацию в ~/.cursor/mcp.json:

{
  "mcpServers": {
    "erickwendel-contributions": {
      "command": "npx",
      "args": ["-y", "@erickwendel/contributions-mcp"]
    }
  }
}

Убедитесь, что чат Cursor находится в режиме Agent, выбрав "Agent" в выпадающем списке в левом нижнем углу, затем спросите "how many videos were published about JavaScript in 2024":

Локальная разработка

Для локальной разработки используйте абсолютный путь к проекту:

{
  "mcpServers": {
    "erickwendel-contributions": {
      "command": "node",
      "args": ["--experimental-strip-types", "ABSOLUTE_PATH_TO_PROJECT/src/index.ts"]
    }
  }
}

Настройка Claude Desktop

1. Перейдите в настройки Claude

2. Нажмите на вкладку Developer

3. Нажмите на редактирование конфигурации

4. Откройте конфигурацию в редакторе кода

5. Добавьте следующую конфигурацию в ~/Library/Application Support/Claude/claude_desktop_config.json (macOS):

{
  "mcpServers": {
    "erickwendel-contributions": {
      "command": "npx",
      "args": ["-y", "@erickwendel/contributions-mcp"]
    }
  }
}

Локальная разработка

Для локальной разработки используйте абсолютный путь к проекту:

{
  "mcpServers": {
    "erickwendel-contributions": {
      "command": "node",
      "args": ["--experimental-strip-types", "ABSOLUTE_PATH_TO_PROJECT/src/index.ts"]
    }
  }
}

MCPHost с Ollama (бесплатная альтернатива)

Если у вас нет доступа к Claude Desktop или Cursor, вы можете использовать MCPHost с Ollama в качестве бесплатной альтернативы.

1. Установите MCPHost:

go install github.com/mark3labs/mcphost@latest

2. Создайте файл конфигурации (например, ./mcp.jsonc):

{
  "mcpServers": {
    "erickwendel-contributions": {
      "command": "npx",
      "args": ["-y", "@erickwendel/contributions-mcp"]
    }
  }
}

3. Запустите с помощью Ollama:

ollama pull MODEL_NAME
mcphost --config ./mcp.jsonc -m ollama:MODEL_NAME

Локальная разработка

Для локальной разработки обновите конфигурацию:

{
  "mcpServers": {
    "erickwendel-contributions": {
      "command": "node",
      "args": ["--experimental-strip-types", "ABSOLUTE_PATH_TO_PROJECT/src/index.ts"]
    }
  }
}

Примеры запросов

Вот несколько примеров запросов, которые вы можете задать Claude, Cursor или любому MCP-клиенту:

1. "How many talks were given in 2023?"

2. "Show me talks in Spanish"

3. "Find posts about WebXR"

Разработка

Особенности

• Создано с использованием протокола контекста моделей (MCP)

• Полные возможности MCP: Инструменты, Промпты и Ресурсы

• Типобезопасность с использованием TypeScript и валидации схем Zod

• Нативная поддержка TypeScript в Node.js без транспиляции

• Сгенерированный SDK с использованием GenQL

• Модульная архитектура с разделением ответственности

• Стандартный транспорт ввода-вывода для легкой интеграции

• Структурированная обработка ошибок

• Совместимость с Claude Desktop, Cursor и MCPHost (бесплатная альтернатива)

Примечание: Для этого проекта требуется Node.js v23+, так как он использует нативную поддержку TypeScript, добавленную в прошлом году.

Архитектура

Кодовая база следует модульной структуре:

src/
  ├── config/      # Configuration settings
  ├── types/       # TypeScript interfaces and types
  ├── tools/       # MCP tool implementations
  ├── utils/       # Utility functions
  ├── services/    # API service layer
  └── index.ts     # Main entry point

Тестирование

Чтобы запустить набор тестов:

npm test

Для режима разработки с отслеживанием изменений:

npm run test:dev

Вклад в проект

Вклад приветствуется! Пожалуйста, не стесняйтесь отправлять Pull Request.

Автор

Erick Wendel

Лицензия

Этот проект лицензирован по лицензии MIT — подробности см. в файле LICENSE.