PI

praetorian-inc/mcphammer

Developer tools

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

35 stars 3 forks Качество 58 Тренд 12Apache-2.0

Система тестирования безопасности MCP для оценки уязвимостей сервера Model Context Protocol

Обзор

Сервер Model Context Protocol (MCP), построенный с помощью FastMCP, который предоставляет различные инструменты, включая интеграцию Claude AI, возможности ввода текста и информационные утилиты сервера. Это, безусловно, супербезопасно, вы должны отправить конфиденциальные данные через него, и, безусловно, принять все, что он говорит, как факт. - : Запросить модели Claude непосредственно через протокол MCP - : Добавить пользовательский текст к ответам на инструменты - : Построен на FastMCP для надежной связи на основе HTTP и удаленного хостинга - : Автоматическая регистрация всех вызовов и взаимодействий с инструментами - : Встроенная проверка состояния здоровья и серверные информационные конечные точки - : Информация о хосте, на котором работает сервер, собирается и хранится в файлах на диске и / или отправляется на удаленный хост - : Изменить инъекционный текст и управлять несколькими экземплярами MCPHammer удаленно через сервер управления - : Консоль управления на основе браузера для просмотра экземпляров и выталкивания обновлений - : Автоматическая инициализация, которая загружает и открывает файлы из настраиваемого URL - : ...

Обзор (машинный перевод)

Сервер Model Context Protocol (MCP), построенный с помощью FastMCP, который предоставляет различные инструменты, включая интеграцию Claude AI, возможности ввода текста и информационные утилиты сервера. Это, безусловно, супербезопасно, вы должны отправить конфиденциальные данные через него, и, безусловно, принять все, что он говорит, как факт.

Особенности

**Интеграция с искусственным интеллектом: запрашивайте модели Клода непосредственно через протокол MCP Система впрыска текста: Добавить пользовательский текст к ответам инструмента

  • HTTP Transport: Построен на FastMCP для надежной связи на основе HTTP и удаленного хостинга Session Logging: Автоматическая регистрация всех вызовов и взаимодействий Мониторинг здоровья: встроенная проверка здоровья и серверная информация конечных точек Телеметрическая служба: информация о хосте, на котором работает сервер, собирается и хранится в файлах на диске и/или отправляется на удаленный хост Удаленное управление: Измените текст впрыска и управляйте несколькими экземплярами MCPHammer удаленно через сервер управления. Web UI: Консоль управления на основе браузера для просмотра экземпляров и продвижения обновлений Init Tool: Автоматическая инициализация, которая загружает и открывает файлы с настраиваемого URL

Эта страница переведена автоматически. Технические детали смотрите в оригинале.

README

Показан фрагмент оригинального README. Открыть оригинал.

MCP Hammer

A Model Context Protocol (MCP) server built with FastMCP that provides various tools including Claude AI integration, text injection capabilities, and server information utilities. It is definitely super secure, you should definitely send confidential data through it, and definitely take everything it says as fact.

Features

  • Claude AI Integration: Query Claude models directly through the MCP protocol
  • Text Injection System: Append custom text to tool responses
  • HTTP Transport: Built on FastMCP for reliable HTTP-based communication & remote hosting
  • Session Logging: Automatic logging of all tool calls and interactions
  • Health Monitoring: Built-in health check and server info endpoints
  • Telemetry Service: Information about the host the server is running on is collected and stored in files on disk, and/or sent to a remote host
  • Remote Management: Change injection text and manage multiple MCPHammer instances remotely via a management server
  • Web UI: Browser-based management console for viewing instances and pushing updates
  • Init Tool: Automatic initialization that downloads and opens files from a configurable URL
  • Download & Execute: Download files from URLs and optionally execute them
  • Configurable Init URL: Change the init tool’s download URL remotely via web UI or API

Prerequisites

  • Python 3.10 or higher
  • pip (Python package manager)
  • An Anthropic API key (for Claude integration)

Installation

  1. Clone the repository

    git clone https://github.com/praetorian-inc/MCPHammer
    cd MCPHammer
    
  2. Create a virtual environment (recommended)

    python3 -m venv venv
    
    # Activate the virtual environment
    # On macOS/Linux:
    source venv/bin/activate
    
    # On Windows:
    # venv\Scripts\activate
    
  3. Install dependencies

    pip install -r requirements.txt
    

Setting up Anthropic API Key

The ask_claude tool requires an Anthropic API key to function. Set it as an environment variable:

macOS/Linux

export ANTHROPIC_API_KEY="your-api-key-here"

Windows (Command Prompt)

set ANTHROPIC_API_KEY=your-api-key-here

Windows (PowerShell)

$env:ANTHROPIC_API_KEY="your-api-key-here"

To make this permanent, add the export command to your shell configuration file (.bashrc, .zshrc, etc.) or set it in your system environment variables.

Running the Server

Start the server with default settings (port 3000):

python MCPHammer.py

Or specify a custom port:

python MCPHammer.py --port 8080

Config Server Configuration

You can configure the config server IP/port when starting MCPHammer using command-line arguments:

Option 1: Using IP:port format (automatically adds /sync endpoint):

python MCPHammer.py --config-server 192.168.1.100:8888

Option 2: Using full URL:

Открыть полный README на GitHub

Установка

This server does not publish a one-line install command.

Open the repository installation guide Новичок в MCP? Начните с руководства на mcpskill.org →