Ханзо МКП

Реализация возможностей Hanzo с использованием протокола контекста модели (MCP).

Обзор

Этот проект предоставляет сервер MCP, реализующий функциональность, подобную Hanzo, что позволяет Клоду напрямую выполнять инструкции по изменению и улучшению файлов проекта. Используя протокол контекста модели, эта реализация обеспечивает бесшовную интеграцию с различными клиентами MCP, включая Claude Desktop.

пример

Функции

Понимание кода : анализ и понимание кодовых баз посредством доступа к файлам и поиска по шаблону.
Изменение кода : внесение целевых изменений в файлы с правильной обработкой разрешений.
Улучшенное выполнение команд : запуск команд и скриптов на разных языках с улучшенной обработкой ошибок и поддержкой оболочки.
Операции с файлами : управление файлами с надлежащим контролем безопасности с помощью команд оболочки.
Обнаружение кода : найдите соответствующие файлы и шаблоны кода в вашем проекте.
Анализ проекта : понимание структуры проекта, зависимостей и фреймворков.
Делегирование полномочий агента : делегирование сложных задач специализированным субагентам, которые могут работать одновременно.
Поддержка нескольких поставщиков LLM : настройка любой модели, совместимой с LiteLLM, для операций агента
Поддержка Jupyter Notebook : чтение и редактирование Jupyter Notebook с полной обработкой ячеек и вывода.

Инструменты Реализованы

Инструмент	Описание
`read_files`	Чтение одного или нескольких файлов с определением кодировки
`write_file`	Создать или перезаписать файлы
`edit_file`	Вносите построчные правки в текстовые файлы.
`directory_tree`	Получить рекурсивное древовидное представление каталогов
`get_file_info`	Получить метаданные о файле или каталоге
`search_content`	Поиск шаблонов в содержимом файла
`content_replace`	Заменить шаблоны в содержимом файла
`run_command`	Выполнение команд оболочки (также используемых для создания каталогов, перемещения файлов и просмотра списка каталогов)
`run_script`	Выполнять скрипты с указанными интерпретаторами
`script_tool`	Выполнять скрипты на определенных языках программирования
`project_analyze_tool`	Анализ структуры проекта и зависимостей
`read_notebook`	Извлечь и прочитать исходный код из всех ячеек в блокноте Jupyter с выходными данными
`edit_notebook`	Редактирование, вставка или удаление ячеек в блокноте Jupyter
`think`	Структурированное пространство для сложных рассуждений и анализа без внесения изменений
`dispatch_agent`	Запустите один или несколько агентов, которые могут выполнять задачи, используя инструменты только для чтения одновременно.

Начиная

Быстрая установка

# Install using uv
uv pip install hanzo-mcp

# Or using pip
pip install hanzo-mcp

Интеграция рабочего стола Клода

Чтобы установить и настроить hanzo-mcp для использования с Claude Desktop:

# Install the package globally
uv pip install hanzo-mcp

# Install configuration to Claude Desktop with default settings
hanzo-mcp --install

Для разработки, если вы хотите установить локальную версию на Claude Desktop:

# Clone and navigate to the repository
git clone https://github.com/hanzoai/mcp.git
cd mcp

# Install and configure for Claude Desktop
make install-desktop

# With custom paths and server name
make install-desktop ALLOWED_PATHS="/path/to/projects,/another/path" SERVER_NAME="hanzo-dev"

# Disable write tools (useful if you prefer using your IDE for edits)
make install-desktop DISABLE_WRITE=1

После установки перезапустите Claude Desktop. Вы увидите "hanzo" (или ваше имя сервера) в раскрывающемся списке серверов MCP.

Подробные инструкции по установке и настройке см. в документации .

Конечно, вы также можете прочитать USEFUL_PROMPTS , чтобы получить вдохновение о том, как использовать hanzo-mcp.

Безопасность

Эта реализация соответствует лучшим практикам по обеспечению безопасности доступа к вашей файловой системе:

Запросы разрешений на изменение файлов и выполнение команд
Ограниченный доступ только к указанным каталогам
Проверка и очистка входных данных
Правильная обработка ошибок и сообщение о них

Документация

Полная документация доступна в каталоге docs . Вы можете создать и просмотреть документацию локально:

# Build the documentation
make docs

# Start a local server to view the documentation
make docs-serve

Затем откройте http://localhost:8000/ в браузере, чтобы просмотреть документацию.

Разработка

Настройка среды разработки

# Clone the repository
git clone https://github.com/hanzoai/mcp.git
cd mcp

# Install Python 3.13 using uv
make install-python

# Setup virtual environment and install dependencies
make setup

# Or install with development dependencies
make install-dev

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

# Run tests
make test

# Run tests with coverage
make test-cov

Строительство и издательское дело

# Build package
make build

# Version bumping
make bump-patch    # Increment patch version (0.1.x → 0.1.x+1)
make bump-minor    # Increment minor version (0.x.0 → 0.x+1.0)
make bump-major    # Increment major version (x.0.0 → x+1.0.0)

# Manual version bumping (alternative to make commands)
python -m scripts.bump_version patch  # Increment patch version
python -m scripts.bump_version minor  # Increment minor version
python -m scripts.bump_version major  # Increment major version

# Publishing (creates git tag and pushes it to GitHub)
make publish                     # Publish using configured credentials in .pypirc
PYPI_TOKEN=your_token make publish  # Publish with token from environment variable

# Publishing (creates git tag, pushes to GitHub, and publishes to PyPI)
make patch    # Bump patch version, build, publish, create git tag, and push
make minor    # Bump minor version, build, publish, create git tag, and push
make major    # Bump major version, build, publish, create git tag, and push

# Publish to Test PyPI
make publish-test

Внося вклад

Чтобы внести свой вклад в этот проект:

Форк репозитория
Создайте ветку функций ( git checkout -b feature/amazing-feature )
Зафиксируйте свои изменения ( git commit -m 'Add some amazing feature' )
Отправить в ветку ( git push origin feature/amazing-feature )
Открыть запрос на извлечение

Лицензия

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

You must be authenticated.

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

Tools

Сервер MCP, который позволяет Клоду и другим клиентам LLM получать доступ к возможностям платформы Hanzo AI и предоставляет мощные инструменты управления кодом для анализа, изменения и понимания проектов.

Related Resources

Reddit Discussion about this server

Related MCP Servers

Awesome MCP FastAPI
MR-GREEN1337
-
security
F
license
-
quality
A production-ready MCP server built with FastAPI, providing an enhanced tool registry for creating, managing, and documenting AI tools for Large Language Models (LLMs).
Last updated -
13
Python
Agent Construct
batteryshark
-
security
A
license
-
quality
An MCP server implementation that standardizes how AI applications access tools and context, providing a central hub that manages tool discovery, execution, and context management with a simplified configuration system.
Last updated -
9
Python
MIT License
MCP Claude Code
SDGLBL
-
security
A
license
-
quality
An MCP server that implements Claude Code-like functionality, allowing the AI to analyze codebases, modify files, execute commands, and manage projects through direct file system interactions.
Last updated -
163
Python
MIT License
Linear
tacticlaunch
A
security
A
license
A
quality
A Model Context Protocol server that enables AI assistants to interact with Linear project management systems, allowing users to retrieve, create, and update issues, projects, and teams through natural language.
Last updated -
32
80
5
TypeScript
MIT License

View all related MCP servers

Hanzo MCP