Paws-on-MCP
Учебный MCP-сервер на Python: поиск по Hacker News, сведения о репозиториях GitHub и примеры запросов семплинга к модели
- 326 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Сервер ходит в сеть к Hacker News и GitHub
- Инструмент request_client_roots просит у клиента доступ к корням файловой системы
Установка
- Работает в
Ручная установка
git clone https://github.com/hemanth/paws-on-mcp.git && cd paws-on-mcp && pip install -r requirements.txt && cd src && python mcp_server.pyСервер поднимается на http://127.0.0.1:8000/mcp/. Этот адрес добавьте в MCP-клиент.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Сервер ходит в сеть к Hacker News и GitHub
- Инструмент request_client_roots просит у клиента доступ к корням файловой системы
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Paws-on-MCP показывает на рабочем коде, как устроены основные части протокола MCP версии 2025-03-26: инструменты, ресурсы, промпты, корни и семплинг. Сервер написан на Python и работает по HTTP на локальном адресе. Предметная часть выбрана простая. Инструмент search_hackernews ищет истории на Hacker News, а get_github_repo_info отдает сведения о репозитории GitHub. Три инструмента просят клиента запустить модель, например code_review_with_ai для ревью кода. В таком запросе передаются подсказка модели и приоритеты интеллекта, цены и скорости. Ресурсов пятнадцать, среди них топ историй, трендовые репозитории GitHub по языкам и состояние сервера. Четырнадцать шаблонов промптов объединены в пять семейств, от тенденций технологий до ревью кода. Для проверки в репозитории есть консольный клиент и набор тестов.
Для кого. Для разработчиков, которые изучают MCP и хотят увидеть на готовом сервере семплинг с предпочтениями модели, ресурсы и шаблоны промптов.
Подходит, если
- Вы изучаете MCP и хотите прочитать код, где рядом лежат инструменты, ресурсы, промпты и корни
- Нужен образец запроса семплинга с подсказкой модели
- Вы строите свой сервер и хотите взять за основу структуру папок с тестами на каждый тип возможностей
- Нужно сверить поведение своего клиента с сервером, который отдает ресурсы под несколькими схемами адресов
Не подходит, если
- Нужен рабочий инструмент для ежедневной работы с GitHub: для этого есть официальный сервер GitHub
- Нужен сервер для рабочей нагрузки с поддержкой: проект учебный
- Нужна установка из реестра пакетов одной командой: пакета нет, сервер запускают из клона
- Ваш клиент не умеет принимать запросы семплинга: три инструмента с ИИ-разбором ничего не вернут
Пример запроса к агенту
Найди на Hacker News пять свежих историй про Python и проанализируй тренды с помощью семплинга. Покажи топ трендовых репозиториев GitHub на Python за день.MCP
- Транспорт
- http
- Авторизация
- не нужна
Ограничения
Сервер запускается только из клона репозитория, пакета в реестре нет. Нужны Python и зависимости из requirements.txt. По словам автора, проходят 3 из 5 групп тестов: корни и расширенный семплинг упираются в ограничения параллелизма в тестовой обвязке. Данные приходят из открытых API Hacker News и GitHub, ключи в настройке не требуются. Инструменты семплинга только формируют запрос к модели и возвращают статус ready_for_client, а сам ответ дает модель на стороне клиента. Репозиторий не обновлялся с июня 2025 года.
Как отключить. Остановите процесс сервера сочетанием Ctrl+C и удалите запись об адресе http://127.0.0.1:8000/mcp/ из конфигурации вашего клиента. Клон репозитория можно удалить как обычную папку.
Частые вопросы
Как запустить Paws-on-MCP?
Склонируйте репозиторий, установите зависимости командой `pip install -r requirements.txt`, перейдите в src и выполните `python mcp_server.py`. Сервер поднимется на http://127.0.0.1:8000/mcp/.
Какие инструменты есть у сервера?
Автор насчитывает девять. Кроме поиска по Hacker News и сведений о репозитории, это запросы корней и промптов сервера, три инструмента семплинга и request_client_roots, который просит корни у клиента.
Что такое расширенный семплинг в этом проекте?
Инструмент create_sampling_request принимает подсказку модели, например claude-3-sonnet, приоритеты, температуру и лимит токенов. Сервер возвращает метод sampling/createMessage и статус ready_for_client.
Как проверить сервер без MCP-клиента?
Используйте консольный клиент: `python mcp_cli_client.py tool search_hackernews --args '{"query": "AI", "limit": 3}'` или чтение ресурса `python mcp_cli_client.py resource hackernews://top/10`.
Чем Paws-on-MCP отличается от официального сервера GitHub?
Это учебная реализация протокола, где GitHub дает лишь сведения о репозитории и список трендов. Официальный сервер покрывает код, задачи, pull request и Actions для ежедневной работы.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыЛокальный граф знаний о коде с историей версий: MCP-сервер отвечает агенту, кто вызывает функцию и что сломается от правки
MCP-сервер, который один раз строит граф кода проекта и отдает агенту готовые ответы вместо повторного перечитывания файлов
MCP-сервер Ref: поиск по документации API и библиотек, который отдает агенту только нужные куски страниц
Docs MCP Server
Grounded Docs MCP Server
Локальный MCP-сервер: индексирует документацию из сайтов, GitHub, npm, PyPI и файлов и дает агенту поиск по нужной версии
MCP-сервер и CLI для исследования кода: поиск и разбор по вашему проекту и по всему GitHub с экономией токенов
MCP-сервер, который дает агенту читать файлы, искать по коду и запускать команды в рабочей папке
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Paws-on-MCP (эта запись) | нет | не нужна | 326 | |
| GitHub MCP Server | нет | ключ необязателен | 34 064 | официальный сервер GitHub для кода, задач, pull request и Actions |
| Idea Reality MCP | нет | не нужна | 826 | проверяет, существует ли уже ваша идея, по GitHub, npm, PyPI и Hacker News |
Коротко о README
Основа проекта — FastMCP, схема на странице показывает, как связаны части сервера. Раздел о текущем состоянии перечисляет, что работает, а что ограничено.