Upload 19 files

.gitignore

@@ -0,0 +1,63 @@
+
+# Logs
+
+logs
+
+*.log
+
+npm-debug.log*
+
+yarn-debug.log*
+
+yarn-error.log*
+
+pnpm-debug.log*
+
+lerna-debug.log*
+
+
+
+node_modules
+
+dist
+
+dist-ssr
+
+*.local
+
+.env
+
+
+
+# Editor directories and files
+
+.vscode/*
+
+!.vscode/extensions.json
+
+.idea
+
+.DS_Store
+
+*.suo
+
+*.ntvs*
+
+*.njsproj
+
+*.sln
+
+*.sw?
+
+
+
+# Python
+
+__pycache__/
+
+*.pyc
+
+.venv
+
+venv/
+

App.tsx

@@ -0,0 +1,283 @@
+
+import React, { useState, useMemo } from 'react';
+
+import { ToolDefinition, GeneratedCode, ToolType, FunctionDefinition, ParameterType } from './types';
+
+import ToolForm from './components/ToolForm';
+
+import CodeOutput from './components/CodeOutput';
+
+import { generateAllCode } from './services/codeGenerator';
+
+import { nmapScannerExample } from './examples';
+
+import Button from './components/ui/Button';
+
+import AiPrompt from './components/AiPrompt';
+
+import { generateToolDefinitionFromPrompt } from './services/aiService';
+
+
+
+const initialFunction: FunctionDefinition = {
+
+  id: crypto.randomUUID(),
+
+  name: 'example_function',
+
+  description: 'Краткое описание того, что делает эта функция.',
+
+  parameters: [
+
+    {
+
+      id: crypto.randomUUID(),
+
+      name: 'example_param',
+
+      type: ParameterType.STRING, // Исправлено с 'str' as any
+
+      description: 'Описание параметра.',
+
+      required: true,
+
+    },
+
+  ],
+
+  returnType: ParameterType.STRING, // Исправлено с 'str' as any
+
+  returnDescription: 'Описание возвращаемого значения.',
+
+};
+
+
+
+const initialToolDefinition: ToolDefinition = {
+
+  name: 'my_tool',
+
+  type: ToolType.UTILITY,
+
+  dependencies: '',
+
+  functions: [initialFunction],
+
+};
+
+
+
+const App: React.FC = () => {
+
+  const [toolDefinition, setToolDefinition] = useState<ToolDefinition>(initialToolDefinition);
+
+  const [aiPrompt, setAiPrompt] = useState<string>('');
+
+  const [isGenerating, setIsGenerating] = useState<boolean>(false);
+
+  const [aiError, setAiError] = useState<string | null>(null);
+
+  
+
+  const generatedCode = useMemo<GeneratedCode | null>(() => {
+
+    try {
+
+      if (toolDefinition.name && toolDefinition.functions.length > 0 && toolDefinition.functions.every(f => f.name)) {
+
+        return generateAllCode(toolDefinition);
+
+      }
+
+      return null;
+
+    } catch (error) {
+
+      console.error("Error generating code:", error);
+
+      return null;
+
+    }
+
+  }, [toolDefinition]);
+
+
+
+  const loadNmapExample = () => {
+
+    setToolDefinition(nmapScannerExample);
+
+  };
+
+
+
+  const handleAiGenerate = async () => {
+
+    if (!aiPrompt.trim()) {
+
+      setAiError("Пожалуйста, введите описание инструмента.");
+
+      return;
+
+    }
+
+    setIsGenerating(true);
+
+    setAiError(null);
+
+    try {
+
+      const jsonString = await generateToolDefinitionFromPrompt(aiPrompt);
+
+      
+
+      // Бэкенд уже должен был очистить markdown, но на всякий случай
+
+      const cleanedJsonString = jsonString.replace(/^```json\s*|\s*```$/g, '').trim();
+
+      const newToolDefinition = JSON.parse(cleanedJsonString);
+
+      
+
+      // Добавим уникальные ID, так как AI их не генерирует
+
+      if (newToolDefinition.functions) {
+
+          newToolDefinition.functions.forEach((func: FunctionDefinition) => {
+
+          func.id = crypto.randomUUID();
+
+          if (func.parameters) {
+
+              func.parameters.forEach((param: any) => {
+
+              param.id = crypto.randomUUID();
+
+            });
+
+          } else {
+
+              func.parameters = []; // Убедимся, что параметры существуют
+
+          }
+
+        });
+
+      } else {
+
+          newToolDefinition.functions = []; // Убедимся, что функции существуют
+
+      }
+
+
+
+      setToolDefinition(newToolDefinition);
+
+
+
+    } catch (error) {
+
+      console.error("AI generation failed:", error);
+
+      setAiError(`Не удалось сгенерировать инструмент: ${error.message}. Проверьте консоль.`);
+
+    } finally {
+
+      setIsGenerating(false);
+
+    }
+
+  };
+
+
+
+  return (
+
+    <div className="min-h-screen bg-gray-900 text-gray-100 p-4 sm:p-6 lg:p-8">
+
+      <div className="max-w-screen-2xl mx-auto">
+
+        <header className="mb-8">
+
+          <div className="text-center">
+
+            <h1 className="text-4xl sm:text-5xl font-bold text-transparent bg-clip-text bg-gradient-to-r from-sky-400 to-blue-600">
+
+              Gemini CLI Tool Generator
+
+            </h1>
+
+            <p className="mt-2 text-lg text-gray-400">
+
+              Создайте кастомные расширения, которые Gemini сможет вызывать для решения ваших задач.
+
+            </p>
+
+          </div>
+
+          <div className="text-center mt-4">
+
+            <Button onClick={loadNmapExample} variant="secondary">
+
+              Загрузить пример: Nmap Scanner
+
+            </Button>
+
+          </div>
+
+        </header>
+
+        
+
+        <AiPrompt
+
+          prompt={aiPrompt}
+
+          setPrompt={setAiPrompt}
+
+          onGenerate={handleAiGenerate}
+
+          isLoading={isGenerating}
+
+          error={aiError}
+
+        />
+
+
+
+        <main className="grid grid-cols-1 xl:grid-cols-2 gap-8 mt-8">
+
+          <ToolForm toolDefinition={toolDefinition} setToolDefinition={setToolDefinition} />
+
+          <CodeOutput generatedCode={generatedCode} toolName={toolDefinition.name} />
+
+        </main>
+
+
+
+        <footer className="text-center mt-12 py-4 border-t border-gray-700">
+
+          <p className="text-gray-500">
+
+            Разработано с использованием React, Tailwind CSS и Gemini.
+
+          </p>
+
+        </footer>
+
+      </div>
+
+    </div>
+
+  );
+
+};
+
+
+
+export default App;
+
+
+
+
+

Dockerfile

@@ -0,0 +1,77 @@
+
+# Этап 1: Сборка React-фронтенда
+
+FROM node:18-slim AS build
+
+WORKDIR /app
+
+
+
+# Копируем package.json и устанавливаем npm зависимости
+
+COPY package.json package-lock.json ./
+
+RUN npm install
+
+
+
+# Копируем остальной код фронтенда
+
+COPY . .
+
+
+
+# Собираем production build (создает папку 'dist')
+
+RUN npm run build
+
+
+
+# Этап 2: Настройка Python-сервера (FastAPI)
+
+FROM python:3.10-slim
+
+WORKDIR /app
+
+
+
+# Установка переменных окружения
+
+ENV PYTHONUNBUFFERED 1
+
+ENV PYTHONDONTWRITEBYTECODE 1
+
+
+
+# Копируем Python-зависимости и устанавливаем их
+
+COPY requirements.txt .
+
+RUN pip install --no-cache-dir -r requirements.txt
+
+
+
+# Копируем код бэкенда (FastAPI)
+
+COPY ./backend ./backend
+
+
+
+# Копируем собранный фронтенд из Этапа 1
+
+COPY --from=build /app/dist ./dist
+
+
+
+# Порт 7860 - стандартный для HF Spaces
+
+EXPOSE 7860
+
+ENV PORT=7860
+
+
+
+# Команда для запуска Uvicorn (FastAPI)
+
+CMD ["uvicorn", "backend.main:app", "--host", "0.0.0.0", "--port", "7860"]
+

GEMINI.md

@@ -0,0 +1,50 @@
+# Инструкция для Агента: Инструмент "nmap_scanner"
+
+## Описание
+
+Этот инструмент предоставляет прямой доступ к сетевому сканеру Nmap для проведения разведки и обнаружения хостов в сети. Он относится к типу **UTILITY**. Используй его для анализа сетевой безопасности, инвентаризации устройств и проверки открытых портов.
+
+## Функции
+
+### `nmap_scanner:run_scan`
+
+Запускает детальное сканирование Nmap на указанные цели. Позволяет гибко настраивать тип сканирования, определять службы и версии ПО.
+
+**Параметры:**
+- `targets` (*str*): Цели для сканирования (IP-адрес, домен, CIDR-диапазон). Например: '192.168.1.1', 'scanme.nmap.org', '10.0.0.0/24'. (обязательный)
+- `ports` (*str*): Порты для сканирования. Например: '21-25,80,443', '1-1024'. (обязательный)
+- `arguments` (*str*): Дополнительные аргументы командной строки Nmap. Например: '-sV -sC' для определения версий и запуска скриптов, или '-A' для агрессивного сканирования. (обязательный)
+
+**Возвращает:**
+*dict* - Результат сканирования в формате JSON, содержащий информацию о хостах, их состоянии, открытых портах, службах и версиях.
+
+---
+
+### `nmap_scanner:host_discovery`
+
+Быстро обнаруживает активные (включенные) хосты в указанной сети с помощью 'ping scan' (`-sn`), не проводя полного сканирования портов.
+
+**Параметры:**
+- `network_cidr` (*str*): Сетевой диапазон в формате CIDR для обнаружения хостов. Например: '192.168.1.0/24'. (обязательный)
+
+**Возвращает:**
+*list* - Список IP-адресов активных хостов, обнаруженных в сети.
+
+## Примеры использования
+
+**ВАЖНО:** Всегда используй формат `nmap_scanner:имя_функции()`.
+
+**Пример 1: Обнаружение всех активных устройств в локальной сети**
+```
+nmap_scanner:host_discovery(network_cidr="192.168.0.0/24")
+```
+
+**Пример 2: Быстрое сканирование популярных портов на конкретном хосте**
+```
+nmap_scanner:run_scan(targets="192.168.1.1", ports="1-1024", arguments="-T4")
+```
+
+**Пример 3: Агрессивное сканирование веб-сервера для определения ОС, служб и уязвимостей**
+```
+nmap_scanner:run_scan(targets="scanme.nmap.org", ports="80,443", arguments="-A -v")
+```

README0.md

@@ -0,0 +1,20 @@
+<div align="center">
+<img width="1200" height="475" alt="GHBanner" src="https://github.com/user-attachments/assets/0aa67016-6eaf-458a-adb2-6e31a0763ed6" />
+</div>
+
+# Run and deploy your AI Studio app
+
+This contains everything you need to run your app locally.
+
+View your app in AI Studio: https://ai.studio/apps/drive/1DWLDNsbZ8bO_lQPzuDVQB3cpW92HgYCC
+
+## Run Locally
+
+**Prerequisites:**  Node.js
+
+
+1. Install dependencies:
+   `npm install`
+2. Set the `GEMINI_API_KEY` in [.env.local](.env.local) to your Gemini API key
+3. Run the app:
+   `npm run dev`

constants.ts

@@ -0,0 +1,18 @@
+
+import { ToolType, ParameterType } from './types';
+
+export const TOOL_TYPES: ToolType[] = Object.values(ToolType);
+export const PARAMETER_TYPES: ParameterType[] = Object.values(ParameterType);
+
+export const PARAMETER_TYPE_DESCRIPTIONS: Record<ParameterType, string> = {
+  [ParameterType.STRING]: 'Текстовая строка (e.g., "hello world").',
+  [ParameterType.INTEGER]: 'Целое число (e.g., 10, -5).',
+  [ParameterType.FLOAT]: 'Число с плавающей точкой (e.g., 3.14).',
+  [ParameterType.BOOLEAN]: 'Логическое значение (True или False).',
+  [ParameterType.LIST]: 'Упорядоченный список элементов (e.g., ["a", "b"]).',
+  [ParameterType.DICTIONARY]: 'Словарь пар ключ-значение (e.g., {"key": "value"}).'
+};
+
+
+
+

examples.ts

@@ -0,0 +1,60 @@
+
+import { ToolDefinition, ToolType, ParameterType } from './types';
+
+export const nmapScannerExample: ToolDefinition = {
+  name: 'nmap_scanner',
+  type: ToolType.UTILITY,
+  dependencies: 'python-nmap',
+  functions: [
+    {
+      id: 'nmap-func-1',
+      name: 'run_scan',
+      description: 'Запускает сканирование Nmap на указанные цели с заданными аргументами. Позволяет выполнять гибкую разведку сети.',
+      parameters: [
+        {
+          id: 'nmap-param-1',
+          name: 'targets',
+          type: ParameterType.STRING,
+          description: "Цели для сканирования (IP, домен, CIDR). Например: '192.168.1.1', 'scanme.nmap.org', '10.0.0.0/24'.",
+          required: true,
+        },
+        {
+          id: 'nmap-param-2',
+          name: 'ports',
+          type: ParameterType.STRING,
+          description: "Порты для сканирования. Например: '21-25,80,443,8080'.",
+          required: true,
+        },
+        {
+          id: 'nmap-param-3',
+          name: 'arguments',
+          type: ParameterType.STRING,
+          description: "Дополнительные аргументы Nmap для тонкой настройки сканирования. Например: '-sV -sC -O'.",
+          required: true,
+        },
+      ],
+      returnType: ParameterType.DICTIONARY,
+      returnDescription: 'Результат сканирования в формате JSON, содержащий информацию о хостах, портах, службах и их версиях.',
+    },
+    {
+      id: 'nmap-func-2',
+      name: 'host_discovery',
+      description: 'Обнаруживает активные хосты в указанной сети (ping scan), не проводя сканирование портов.',
+      parameters: [
+        {
+          id: 'nmap-param-4',
+          name: 'network_cidr',
+          type: ParameterType.STRING,
+          description: "Сетевой диапазон в формате CIDR для обнаружения хостов. Например: '192.168.1.0/24'.",
+          required: true,
+        },
+      ],
+      returnType: ParameterType.LIST,
+      returnDescription: 'Список IP-адресов активных хостов, обнаруженных в сети.',
+    },
+  ],
+};
+
+
+
+

index.html

@@ -1,19 +1,45 @@
-<!doctype html>
-<html>
-	<head>
-		<meta charset="utf-8" />
-		<meta name="viewport" content="width=device-width" />
-		<title>My static Space</title>
-		<link rel="stylesheet" href="style.css" />
-	</head>
-	<body>
-		<div class="card">
-			<h1>Welcome to your static Space!</h1>
-			<p>You can modify this app directly by editing <i>index.html</i> in the Files and versions tab.</p>
-			<p>
-				Also don't forget to check the
-				<a href="https://huggingface.co/docs/hub/spaces" target="_blank">Spaces documentation</a>.
-			</p>
-		</div>
-	</body>
-</html>
+
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>FastMCP Tool Generator</title>
+    <script src="https://cdn.tailwindcss.com"></script>
+    <script src="https://cdnjs.cloudflare.com/ajax/libs/jszip/3.10.1/jszip.min.js"></script>
+    <style>
+      /* Custom scrollbar for webkit browsers */
+      ::-webkit-scrollbar {
+        width: 8px;
+        height: 8px;
+      }
+      ::-webkit-scrollbar-track {
+        background: #1f2937; /* bg-gray-800 */
+      }
+      ::-webkit-scrollbar-thumb {
+        background: #4b5563; /* bg-gray-600 */
+        border-radius: 4px;
+      }
+      ::-webkit-scrollbar-thumb:hover {
+        background: #6b7280; /* bg-gray-500 */
+      }
+    </style>
+  <script type="importmap">
+{
+  "imports": {
+    "react": "https://aistudiocdn.com/react@^19.2.0",
+    "react-dom/": "https://aistudiocdn.com/react-dom@^19.2.0/",
+    "react/": "https://aistudiocdn.com/react@^19.2.0/",
+    "@google/genai": "https://aistudiocdn.com/@google/genai@^1.29.0"
+  }
+}
+</script>
+<link rel="stylesheet" href="/index.css">
+</head>
+  <body class="bg-gray-900 text-gray-100">
+    <div id="root"></div>
+    <script type="module" src="/index.tsx"></script>
+  </body>
+</html>
+
+

index.tsx

@@ -0,0 +1,20 @@
+
+import React from 'react';
+import ReactDOM from 'react-dom/client';
+import App from './App';
+
+const rootElement = document.getElementById('root');
+if (!rootElement) {
+  throw new Error("Could not find root element to mount to");
+}
+
+const root = ReactDOM.createRoot(rootElement);
+root.render(
+  <React.StrictMode>
+    <App />
+  </React.StrictMode>
+);
+
+
+
+

metadata.json

@@ -0,0 +1,7 @@
+{
+  "name": "Copy of Copy of Copy of FastMCP Tool Generator",
+  "description": "A web application to generate complete, self-contained, and deployable FastMCP tool boilerplates for Gemini CLI based on user's technical requirements. It creates all necessary files including server logic, setup configuration, and agent instructions.",
+  "requestFramePermissions": []
+}
+
+

package.json

@@ -0,0 +1,42 @@
+
+{
+  "name": "fastmcp-tool-generator-hf",
+  "version": "0.0.0",
+  "private": true,
+  "scripts": {
+    "dev": "vite",
+    "build": "tsc && vite build",
+    "lint": "eslint . --ext ts,tsx --report-unused-disable-directives --max-warnings 0",
+    "preview": "vite preview"
+  },
+  "dependencies": {
+    "autoprefixer": "^10.4.19",
+    "axios": "^1.7.2",
+    "highlight.js": "^11.9.0",
+    "jszip": "^3.10.1",
+    "postcss": "^8.4.38",
+    "react": "^18.2.0",
+    "react-dom": "^18.2.0",
+    "react-hot-toast": "^2.4.1",
+    "tailwindcss": "^3.4.4"
+  },
+  "devDependencies": {
+    "@types/highlight.js": "^10.1.0",
+    "@types/jszip": "^3.10.1",
+    "@types/react": "^18.2.66",
+    "@types/react-dom": "^18.2.22",
+    "@typescript-eslint/eslint-plugin": "^7.2.0",
+    "@typescript-eslint/parser": "^7.2.0",
+    "@vitejs/plugin-react": "^4.2.1",
+    "eslint": "^8.57.0",
+    "eslint-plugin-react-hooks": "^4.6.0",
+    "eslint-plugin-react-refresh": "^0.4.6",
+    "typescript": "^5.2.2",
+    "vite": "^5.2.0"
+  }
+}
+
+
+
+
+

requirements.txt

@@ -0,0 +1,11 @@
+
+fastapi
+
+uvicorn[standard]
+
+google-generativeai
+
+pydantic
+
+python-dotenv
+

tsconfig.json

@@ -0,0 +1,32 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "experimentalDecorators": true,
+    "useDefineForClassFields": false,
+    "module": "ESNext",
+    "lib": [
+      "ES2022",
+      "DOM",
+      "DOM.Iterable"
+    ],
+    "skipLibCheck": true,
+    "types": [
+      "node"
+    ],
+    "moduleResolution": "bundler",
+    "isolatedModules": true,
+    "moduleDetection": "force",
+    "allowJs": true,
+    "jsx": "react-jsx",
+    "paths": {
+      "@/*": [
+        "./*"
+      ]
+    },
+    "allowImportingTsExtensions": true,
+    "noEmit": true
+  }
+}
+
+
+

types.ts

@@ -0,0 +1,72 @@
+
+export enum ToolType {
+  REST_API = 'REST_API',
+  CLI = 'CLI',
+  DATABASE = 'DATABASE',
+  CUSTOM = 'CUSTOM',
+  UTILITY = 'UTILITY',
+  CALCULATOR = 'CALCULATOR',
+  CONVERTER = 'CONVERTER'
+}
+
+export enum ParameterType {
+  STRING = 'str',
+  INTEGER = 'int',
+  FLOAT = 'float',
+  BOOLEAN = 'bool',
+  LIST = 'list',
+  DICTIONARY = 'dict'
+}
+
+export interface ParameterDefinition {
+  id: string;
+  name: string;
+  type: ParameterType;
+  description: string;
+  required: boolean;
+}
+
+export interface FunctionDefinition {
+  id: string;
+  name: string;
+  description: string;
+  parameters: ParameterDefinition[];
+  returnType: ParameterType;
+  returnDescription: string;
+}
+
+export interface ToolDefinition {
+  name: string;
+  type: ToolType;
+  dependencies: string;
+  functions: FunctionDefinition[];
+}
+
+export interface GeneratedCode {
+  setupPy: string;
+  serverPy: string;
+  settingsJson: string;
+  geminiMd: string;
+  examplesMd: string;
+}
+
+// Экспортируем для использования в AI промпте
+export const initialFunctionForPrompt: Omit<FunctionDefinition, 'id'> = {
+  name: 'example_function',
+  description: 'Краткое описание того, что делает эта функция.',
+  parameters: [
+    {
+      id: 'param-id-1', // id здесь для примера, в реальности он генерируется
+      name: 'example_param',
+      type: ParameterType.STRING,
+      description: 'Описание параметра.',
+      required: true,
+    },
+  ],
+  returnType: ParameterType.STRING,
+  returnDescription: 'Описание возвращаемого значения.',
+};
+
+
+
+

vite.config.ts

@@ -0,0 +1,72 @@
+import path from 'path';
+
+import { defineConfig, loadEnv } from 'vite';
+
+import react from '@vitejs/plugin-react';
+
+
+
+export default defineConfig(({ mode }) => {
+
+    const env = loadEnv(mode, '.', '');
+
+    
+
+    // Порт для FastAPI (бэкенда) при локальной разработке
+
+    const PYTHON_BACKEND_PORT = 8000;
+
+
+
+    return {
+
+      server: {
+
+        // Используем порт 3000 для Vite (фронтенда)
+
+        port: 3000,
+
+        host: '0.0.0.0',
+
+        proxy: {
+
+          // Перенаправляем все /api запросы на наш Python бэкенд
+
+          '/api': {
+
+            target: `http://127.0.0.1:${PYTHON_BACKEND_PORT}`, // ИСПРАВЛЕНО
+
+            changeOrigin: true,
+
+            secure: false,
+
+          }
+
+        }
+
+      },
+
+      plugins: [react()],
+
+      define: {
+
+        // Ключ API БОЛЬШЕ НЕ НУЖЕН в define!
+
+      },
+
+      resolve: {
+
+        alias: {
+
+          '@': path.resolve(__dirname, '.'),
+
+        }
+
+      }
+
+    };
+
+});
+
+
+