[{"_1":2,"_414":-5,"_415":-5},"loaderData",{"_3":4,"_24":25,"_317":318},"root",{"_5":6,"_7":8},"toasts",[],"visitor",{"_9":10,"_11":12},"viewportWidth",1280,"visitorSession",{"_13":14,"_16":17,"_18":-5,"_19":20,"_21":22,"_23":-5},"attributes",[15],"bot","id",25525284,"membership","referenceId","019a8532-3486-77ed-91a9-43b1bf5feeec","unreadReleaseNotesCount",2,"userAccount","routes/_public/mcp/servers/~namespace/~slug/_pages/_layout",{"_26":27,"_83":-5,"_84":41,"_29":85,"_235":236,"_315":316},"availableLocales",[28,41,48,55,62,69,76],{"_29":30,"_37":38,"_39":40},"mcpServer",{"_31":32,"_33":34,"_35":36},"description","MCP-Server, der KI-Assistenten mit der ReviewWebsite.com-API verbindet, um Website-Bewertungen zu erstellen und zu verwalten, Daten zu extrahieren, URLs in Markdown zu konvertieren und mit Webinhalten zu interagieren.","displayName","ReviewWebsite MCP-Server","readme","# ReviewWebsite.com - MCP-Server\n\nDieses Projekt bietet einen Model Context Protocol (MCP)-Server, der KI-Assistenten mit der [ReviewWebsite.com](https://reviewweb.site) -API verbindet, um Website-Bewertungen zu erstellen und zu verwalten, Daten zu extrahieren, URLs in Markdown zu konvertieren und mehr.\n\n* [Github](https://github.com/mrgoonie/reviewwebsite-mcp-server)\n* [NPM](https://www.npmjs.com/package/reviewwebsite-mcp-server)\n\n### Verfügbare Funktionen\n\n* \\[x] Website-Bewertungen erstellen, lesen, aktualisieren und löschen\n* \\[x] Verfügbare KI-Modelle abrufen\n* \\[x] URLs mithilfe von KI in Markdown konvertieren\n* \\[x] Extrahieren Sie mithilfe von KI strukturierte Daten aus URLs\n* \\[x] URLs scrapen und Inhalte extrahieren\n* \\[x] Links von Websites extrahieren\n* \\[x] URLs und Websites mithilfe von KI zusammenfassen\n* \\[x] SEO-Einblicke (Keyword-Ideen, Keyword-Schwierigkeit, Verkehrsanalyse, Backlinks)\n* \\[x] KI-Modelle und Parameter anpassen\n* \\[x] Warteverhalten und -zeitpunkt steuern\n\n## ReviewWeb.site\n\n* [Webseite](https://reviewweb.site)\n* [API-Dokumente](https://reviewweb.site/api-docs/)\n* [API Swagger-Konfiguration](https://reviewweb.site/api-docs/swagger-ui-init.js)\n* Erstellen Sie [hier](https://reviewweb.site/profile) Ihren API-Schlüssel\n\n## Unterstützte Transporte\n\n* \\[x] [\"stdio\"](https://modelcontextprotocol.io/specification/2025-03-26/basic/transports#stdio) -Transport - Standardtransport für die CLI-Nutzung\n* \\[x][\"Streamable HTTP\"](https://modelcontextprotocol.io/specification/2025-03-26/basic/transports#streamable-http) -Transport - Für webbasierte Clients\n * \\[ ] Implementieren Sie Auth (\"Authorization\"-Header mit `Bearer ` )\n* \\[ ] ~~\"sse\"-Transport~~ **[(Veraltet)](https://modelcontextprotocol.io/specification/2025-03-26/basic/transports#backwards-compatibility)**\n* \\[ ] Tests schreiben\n\n## Anwendung\n\n### Befehlszeilenschnittstelle (CLI)\n\n```bash\n# Get available AI models\nnpm run dev:cli -- get-ai-models --api-key \"your-api-key\"\n\n# Create a new review\nnpm run dev:cli -- create-review --url \"https://example.com\" --instructions \"Review this website\" --api-key \"your-api-key\"\n\n# Get a specific review by ID\nnpm run dev:cli -- get-review --review-id \"review-id\" --api-key \"your-api-key\"\n\n# List all reviews\nnpm run dev:cli -- list-reviews --page 1 --limit 10 --api-key \"your-api-key\"\n\n# Update a review\nnpm run dev:cli -- update-review --review-id \"review-id\" --url \"https://example.com\" --instructions \"Updated instructions\" --api-key \"your-api-key\"\n\n# Delete a review\nnpm run dev:cli -- delete-review --review-id \"review-id\" --api-key \"your-api-key\"\n\n# Convert URL to Markdown\nnpm run dev:cli -- convert-to-markdown --url \"https://example.com\" --model \"gpt-4o\" --api-key \"your-api-key\"\n\n# Extract structured data from URL\nnpm run dev:cli -- extract-data --url \"https://example.com\" --instructions \"Extract product information\" --api-key \"your-api-key\"\n\n# Scrape URL\nnpm run dev:cli -- scrape-url --url \"https://example.com\" --api-key \"your-api-key\"\n\n# Extract links from URL\nnpm run dev:cli -- extract-links --url \"https://example.com\" --type \"all\" --api-key \"your-api-key\"\n\n# Summarize URL\nnpm run dev:cli -- summarize-url --url \"https://example.com\" --model \"gpt-4o\" --api-key \"your-api-key\"\n\n# Get keyword ideas for SEO\nnpm run dev:cli -- seo-keyword-ideas --keyword \"digital marketing\" --country \"us\" --search-engine \"Google\" --api-key \"your-api-key\"\n\n# Check keyword difficulty\nnpm run dev:cli -- seo-keyword-difficulty --keyword \"digital marketing\" --country \"us\" --api-key \"your-api-key\"\n\n# Analyze website traffic\nnpm run dev:cli -- seo-traffic --domain-or-url \"example.com\" --mode \"subdomains\" --country \"us\" --api-key \"your-api-key\"\n\n# Get backlinks for a domain\nnpm run dev:cli -- seo-backlinks --domain \"example.com\" --api-key \"your-api-key\"\n```\n\n### MCP-Einrichtung\n\n**Für die lokale Konfiguration mit stdio-Transport:**\n\n```json\n{\n \"mcpServers\": {\n \"reviewwebsite\": {\n \"command\": \"node\",\n \"args\": [\"/path/to/reviewwebsite-mcp-server/dist/index.js\"],\n \"transportType\": \"stdio\"\n }\n }\n}\n```\n\n**Für die Remote-HTTP-Konfiguration:**\n\n```json\n{\n \"mcpServers\": {\n \"reviewwebsite\": {\n \"type\": \"http\",\n \"url\": \"http://localhost:8080/mcp\"\n }\n }\n}\n```\n\n**Umgebungsvariablen für den HTTP-Transport:**\n\nSie können den HTTP-Server mit diesen Umgebungsvariablen konfigurieren:\n\n* `MCP_HTTP_HOST` : Der Host, an den die Verbindung hergestellt werden soll (Standard: `127.0.0.1` )\n* `MCP_HTTP_PORT` : Der Port, auf dem gewartet werden soll (Standard: `8080` )\n* `MCP_HTTP_PATH` : Der Endpunktpfad (Standard: `/mcp` )\n\n***\n\n# Quellcodeübersicht\n\n## Was ist MCP?\n\nModel Context Protocol (MCP) ist ein offener Standard, der es KI-Systemen ermöglicht, sich sicher und kontextbezogen mit externen Tools und Datenquellen zu verbinden.\n\nDieses Boilerplate implementiert die MCP-Spezifikation mit einer sauberen, geschichteten Architektur, die erweitert werden kann, um benutzerdefinierte MCP-Server für jede API oder Datenquelle zu erstellen.\n\n## Warum diesen Standardtext verwenden?\n\n* **Produktionsreife Architektur** : Folgt dem gleichen Muster wie veröffentlichte MCP-Server, mit klarer Trennung zwischen CLI, Tools, Controllern und Diensten.\n\n* **Typsicherheit** : Erstellt mit TypeScript für verbesserte Entwicklererfahrung, Codequalität und Wartbarkeit.\n\n* **Funktionierendes Beispiel** : Enthält ein vollständig implementiertes IP-Lookup-Tool, das das komplette Muster von der CLI- bis zur API-Integration demonstriert.\n\n* **Testframework** : Wird mit einer Testinfrastruktur für Unit- und CLI-Integrationstests geliefert, einschließlich Abdeckungsberichten.\n\n* **Entwicklungstools** : Enthält ESLint, Prettier, TypeScript und andere hochwertige Tools, die für die MCP-Serverentwicklung vorkonfiguriert sind.\n\n***\n\n# Erste Schritte\n\n## Voraussetzungen\n\n* **Node.js** (>=18.x): [Herunterladen](https://nodejs.org/)\n* **Git** : Zur Versionskontrolle\n\n***\n\n## Schritt 1: Klonen und installieren\n\n```bash\n# Clone the repository\ngit clone https://github.com/mrgoonie/reviewwebsite-mcp-server.git\ncd reviewwebsite-mcp-server\n\n# Install dependencies\nnpm install\n```\n\n***\n\n## Schritt 2: Entwicklungsserver ausführen\n\nStarten Sie den Server im Entwicklungsmodus mit stdio-Transport (Standard):\n\n```bash\nnpm run dev:server\n```\n\nOder mit dem Streamable HTTP-Transport:\n\n```bash\nnpm run dev:server:http\n```\n\nDadurch wird der MCP-Server mit Hot-Reloading gestartet und der MCP Inspector unter aktiviert.\n\n⚙️ Proxyserver lauscht auf Port 6277 🔍 MCP Inspector ist unter aktiv\n\nBei Verwendung des HTTP-Transports ist der Server standardmäßig unter verfügbar.\n\n***\n\n## Schritt 3: Testen Sie die ReviewWebsite-API-Tools\n\nVerwenden Sie die ReviewWebsite-API-Tools über die CLI:\n\n```bash\n# Get available AI models\nnpm run dev:cli -- get-ai-models --api-key \"your-api-key\"\n\n# Create a review\nnpm run dev:cli -- create-review --url \"https://example.com\" --instructions \"Review this website\" --api-key \"your-api-key\"\n\n# Convert URL to Markdown\nnpm run dev:cli -- convert-to-markdown --url \"https://example.com\" --model \"gpt-4o\" --api-key \"your-api-key\"\n```\n\n***\n\n# Architektur\n\nDieser Standardtext folgt einem klaren, geschichteten Architekturmuster, das Belange trennt und die Wartbarkeit fördert.\n\n## Projektstruktur\n\n```\nsrc/\n├── cli/ # Command-line interfaces\n├── controllers/ # Business logic\n├── resources/ # MCP resources: expose data and content from your servers to LLMs\n├── services/ # External API interactions\n├── tools/ # MCP tool definitions\n├── types/ # Type definitions\n├── utils/ # Shared utilities\n└── index.ts # Entry point\n```\n\n## Ebenen und Verantwortlichkeiten\n\n### CLI-Schicht ( `src/cli/*.cli.ts` )\n\n* **Zweck** : Definieren Sie Befehlszeilenschnittstellen, die Argumente analysieren und Controller aufrufen\n* **Benennung** : Dateien sollten `.cli.ts` heißen\n* **Testen** : CLI-Integrationstests in `.cli.test.ts`\n\n### Tools-Ebene ( `src/tools/*.tool.ts` )\n\n* **Zweck** : Definieren Sie MCP-Tools mit Schemata und Beschreibungen für KI-Assistenten\n* **Benennung** : Dateien sollten `.tool.ts` mit Typen in `.types.ts` benannt werden\n* **Muster** : Jedes Tool sollte zod zur Argumentvalidierung verwenden\n\n### Controller-Ebene ( `src/controllers/*.controller.ts` )\n\n* **Zweck** : Implementieren Sie Geschäftslogik, behandeln Sie Fehler und formatieren Sie Antworten\n* **Benennung** : Dateien sollten `.controller.ts` heißen\n* **Muster** : Sollte standardisierte `ControllerResponse` Objekte zurückgeben\n\n### Serviceebene ( `src/services/*.service.ts` )\n\n* **Zweck** : Interaktion mit externen APIs oder Datenquellen\n* **Benennung** : Dateien sollten `.service.ts` heißen\n* **Muster** : Reine API-Interaktionen mit minimaler Logik\n\n### Utils-Ebene ( `src/utils/*.util.ts` )\n\n* **Zweck** : Bereitstellung gemeinsamer Funktionen für die gesamte Anwendung\n* **Wichtige Dienstprogramme** :\n * `logger.util.ts` : Strukturiertes Protokollieren\n * `error.util.ts` : Fehlerbehandlung und Standardisierung\n * `formatter.util.ts` : Markdown-Formatierungshilfen\n\n***\n\n# Entwicklungshandbuch\n\n## Entwicklungsskripte\n\n```bash\n# Start server in development mode (hot-reload & inspector)\nnpm run dev:server\n\n# Run CLI in development mode\nnpm run dev:cli -- [command] [args]\n\n# Build the project\nnpm run build\n\n# Start server in production mode\nnpm run start:server\n\n# Run CLI in production mode\nnpm run start:cli -- [command] [args]\n```\n\n## Testen\n\n```bash\n# Run all tests\nnpm test\n\n# Run specific tests\nnpm test -- src/path/to/test.ts\n\n# Generate test coverage report\nnpm run test:coverage\n```\n\n## Codequalität\n\n```bash\n# Lint code\nnpm run lint\n\n# Format code with Prettier\nnpm run format\n\n# Check types\nnpm run typecheck\n```\n\n***\n\n# Erstellen benutzerdefinierter Tools\n\nBefolgen Sie diese Schritte, um dem Server Ihre eigenen Tools hinzuzufügen:\n\n## 1. Service-Layer definieren\n\nErstellen Sie einen neuen Dienst in `src/services/` um mit Ihrer externen API zu interagieren:\n\n```typescript\n// src/services/example.service.ts\nimport { Logger } from '../utils/logger.util.js';\n\nconst logger = Logger.forContext('services/example.service.ts');\n\nexport async function getData(param: string): Promise {\n\tlogger.debug('Getting data', { param });\n\t// API interaction code here\n\treturn { result: 'example data' };\n}\n```\n\n## 2. Controller erstellen\n\nFügen Sie einen Controller in `src/controllers/` hinzu, um die Geschäftslogik zu handhaben:\n\n```typescript\n// src/controllers/example.controller.ts\nimport { Logger } from '../utils/logger.util.js';\nimport * as exampleService from '../services/example.service.js';\nimport { formatMarkdown } from '../utils/formatter.util.js';\nimport { handleControllerError } from '../utils/error-handler.util.js';\nimport { ControllerResponse } from '../types/common.types.js';\n\nconst logger = Logger.forContext('controllers/example.controller.ts');\n\nexport interface GetDataOptions {\n\tparam?: string;\n}\n\nexport async function getData(\n\toptions: GetDataOptions = {},\n): Promise {\n\ttry {\n\t\tlogger.debug('Getting data with options', options);\n\n\t\tconst data = await exampleService.getData(options.param || 'default');\n\n\t\tconst content = formatMarkdown(data);\n\n\t\treturn { content };\n\t} catch (error) {\n\t\tthrow handleControllerError(error, {\n\t\t\tentityType: 'ExampleData',\n\t\t\toperation: 'getData',\n\t\t\tsource: 'controllers/example.controller.ts',\n\t\t});\n\t}\n}\n```\n\n## 3. Implementieren Sie das MCP-Tool\n\nErstellen Sie eine Tooldefinition in `src/tools/` :\n\n```typescript\n// src/tools/example.tool.ts\nimport { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport { z } from 'zod';\nimport { Logger } from '../utils/logger.util.js';\nimport { formatErrorForMcpTool } from '../utils/error.util.js';\nimport * as exampleController from '../controllers/example.controller.js';\n\nconst logger = Logger.forContext('tools/example.tool.ts');\n\nconst GetDataArgs = z.object({\n\tparam: z.string().optional().describe('Optional parameter'),\n});\n\ntype GetDataArgsType = z.infer;\n\nasync function handleGetData(args: GetDataArgsType) {\n\ttry {\n\t\tlogger.debug('Tool get_data called', args);\n\n\t\tconst result = await exampleController.getData({\n\t\t\tparam: args.param,\n\t\t});\n\n\t\treturn {\n\t\t\tcontent: [{ type: 'text' as const, text: result.content }],\n\t\t};\n\t} catch (error) {\n\t\tlogger.error('Tool get_data failed', error);\n\t\treturn formatErrorForMcpTool(error);\n\t}\n}\n\nexport function register(server: McpServer) {\n\tserver.tool(\n\t\t'get_data',\n\t\t`Gets data from the example API, optionally using \\`param\\`.\nUse this to fetch example data. Returns formatted data as Markdown.`,\n\t\tGetDataArgs.shape,\n\t\thandleGetData,\n\t);\n}\n```\n\n## 4. CLI-Unterstützung hinzufügen\n\nErstellen Sie einen CLI-Befehl in `src/cli/` :\n\n```typescript\n// src/cli/example.cli.ts\nimport { program } from 'commander';\nimport { Logger } from '../utils/logger.util.js';\nimport * as exampleController from '../controllers/example.controller.js';\nimport { handleCliError } from '../utils/error-handler.util.js';\n\nconst logger = Logger.forContext('cli/example.cli.ts');\n\nprogram\n\t.command('get-data')\n\t.description('Get example data')\n\t.option('--param ', 'Optional parameter')\n\t.action(async (options) => {\n\t\ttry {\n\t\t\tlogger.debug('CLI get-data called', options);\n\n\t\t\tconst result = await exampleController.getData({\n\t\t\t\tparam: options.param,\n\t\t\t});\n\n\t\t\tconsole.log(result.content);\n\t\t} catch (error) {\n\t\t\thandleCliError(error);\n\t\t}\n\t});\n```\n\n## 5. Komponenten registrieren\n\nAktualisieren Sie die Einstiegspunkte, um Ihre neuen Komponenten zu registrieren:\n\n```typescript\n// In src/cli/index.ts\nimport '../cli/example.cli.js';\n\n// In src/index.ts (for the tool)\nimport exampleTool from './tools/example.tool.js';\n// Then in registerTools function:\nexampleTool.register(server);\n```\n\n***\n\n# Debugging-Tools\n\n## MCP-Inspektor\n\nGreifen Sie auf den visuellen MCP-Inspektor zu, um Ihre Tools zu testen und Anforderungs-/Antwortdetails anzuzeigen:\n\n1. Führen Sie `npm run dev:server`\n2. Öffnen Sie in Ihrem Browser\n3. Testen Sie Ihre Tools und zeigen Sie Protokolle direkt in der Benutzeroberfläche an\n\n## Serverprotokolle\n\nAktivieren Sie Debug-Protokolle für die Entwicklung:\n\n```bash\n# Set environment variable\nDEBUG=true npm run dev:server\n\n# Or configure in ~/.mcp/configs.json\n```\n\n***\n\n# Veröffentlichen Ihres MCP-Servers\n\nWenn Sie bereit sind, Ihren benutzerdefinierten MCP-Server zu veröffentlichen:\n\n1. Aktualisieren Sie package.json mit Ihren Details\n2. Aktualisieren Sie README.md mit Ihrer Tool-Dokumentation\n3. Erstellen Sie das Projekt: `npm run build`\n4. Testen Sie den Produktionsbuild: `npm run start:server`\n5. Auf npm veröffentlichen: `npm publish`\n\n***\n\n# Lizenz\n\n[MIT-Lizenz](https://opensource.org/licenses/MIT)\n\n```json\n{\n\t\"reviewwebsite\": {\n\t\t\"environments\": {\n\t\t\t\"DEBUG\": \"true\",\n\t\t\t\"REVIEWWEBSITE_API_KEY\": \"your-api-key-here\"\n\t\t}\n\t}\n}\n```\n\n**Hinweis:** Aus Gründen der Abwärtskompatibilität erkennt der Server auch Konfigurationen mit dem vollständigen Paketnamen ( `reviewwebsite-mcp-server` ) oder dem Paketnamen ohne Gültigkeitsbereich ( `reviewwebsite-mcp-server` ), wenn der `reviewwebsite` Schlüssel nicht gefunden wird. Für neue Konfigurationen wird jedoch die Verwendung des kurzen `reviewwebsite` -Schlüssels empfohlen.","name","German","tag","de-DE",{"_29":42,"_37":46,"_39":47},{"_31":43,"_33":44,"_35":45},"MCP server that connects AI assistants to ReviewWebsite.com API for creating and managing website reviews, extracting data, converting URLs to markdown, and interacting with web content.","ReviewWebsite MCP Server","# ReviewWebsite.com - MCP Server\n\nThis project provides a Model Context Protocol (MCP) server that connects AI assistants to [ReviewWebsite.com](https://reviewweb.site) API to create and manage website reviews, extract data, convert URLs to markdown, and more.\n\n\n $\"ReviewWebsite$ \n\n\n- [Github](https://github.com/mrgoonie/reviewwebsite-mcp-server)\n- [NPM](https://www.npmjs.com/package/reviewwebsite-mcp-server)\n\n### Available Features\n- [x] Create, read, update, and delete website reviews\n- [x] Get available AI models\n- [x] Convert URLs to Markdown using AI\n- [x] Extract structured data from URLs using AI\n- [x] Scrape URLs and extract content\n- [x] Extract links from websites\n- [x] Summarize URLs and websites using AI\n- [x] SEO insights (keyword ideas, keyword difficulty, traffic analysis, backlinks)\n- [x] Customize AI models and parameters\n- [x] Control wait behavior and timing\n\n## ReviewWeb.site\n\n- [Website](https://reviewweb.site)\n- [API Docs](https://reviewweb.site/api-docs/)\n- [API Swagger Config](https://reviewweb.site/api-docs/swagger-ui-init.js)\n- Create your API key [here](https://reviewweb.site/profile)\n\n## Supported Transports\n\n- [x] [\"stdio\"](https://modelcontextprotocol.io/specification/2025-03-26/basic/transports#stdio) transport - Default transport for CLI usage\n- [x] [\"Streamable HTTP\"](https://modelcontextprotocol.io/specification/2025-03-26/basic/transports#streamable-http) transport - For web-based clients\n - [ ] Implement auth (\"Authorization\" headers with `Bearer `)\n- [ ] ~~\"sse\" transport~~ **[(Deprecated)](https://modelcontextprotocol.io/specification/2025-03-26/basic/transports#backwards-compatibility)**\n- [ ] Write tests\n\n## How to use\n\n### CLI\n\n```bash\n# Get available AI models\nnpm run dev:cli -- get-ai-models --api-key \"your-api-key\"\n\n# Create a new review\nnpm run dev:cli -- create-review --url \"https://example.com\" --instructions \"Review this website\" --api-key \"your-api-key\"\n\n# Get a specific review by ID\nnpm run dev:cli -- get-review --review-id \"review-id\" --api-key \"your-api-key\"\n\n# List all reviews\nnpm run dev:cli -- list-reviews --page 1 --limit 10 --api-key \"your-api-key\"\n\n# Update a review\nnpm run dev:cli -- update-review --review-id \"review-id\" --url \"https://example.com\" --instructions \"Updated instructions\" --api-key \"your-api-key\"\n\n# Delete a review\nnpm run dev:cli -- delete-review --review-id \"review-id\" --api-key \"your-api-key\"\n\n# Convert URL to Markdown\nnpm run dev:cli -- convert-to-markdown --url \"https://example.com\" --model \"gpt-4o\" --api-key \"your-api-key\"\n\n# Extract structured data from URL\nnpm run dev:cli -- extract-data --url \"https://example.com\" --instructions \"Extract product information\" --api-key \"your-api-key\"\n\n# Scrape URL\nnpm run dev:cli -- scrape-url --url \"https://example.com\" --api-key \"your-api-key\"\n\n# Extract links from URL\nnpm run dev:cli -- extract-links --url \"https://example.com\" --type \"all\" --api-key \"your-api-key\"\n\n# Summarize URL\nnpm run dev:cli -- summarize-url --url \"https://example.com\" --model \"gpt-4o\" --api-key \"your-api-key\"\n\n# Get keyword ideas for SEO\nnpm run dev:cli -- seo-keyword-ideas --keyword \"digital marketing\" --country \"us\" --search-engine \"Google\" --api-key \"your-api-key\"\n\n# Check keyword difficulty\nnpm run dev:cli -- seo-keyword-difficulty --keyword \"digital marketing\" --country \"us\" --api-key \"your-api-key\"\n\n# Analyze website traffic\nnpm run dev:cli -- seo-traffic --domain-or-url \"example.com\" --mode \"subdomains\" --country \"us\" --api-key \"your-api-key\"\n\n# Get backlinks for a domain\nnpm run dev:cli -- seo-backlinks --domain \"example.com\" --api-key \"your-api-key\"\n```\n\n### MCP Setup\n\n**For local configuration with stdio transport:**\n```json\n{\n \"mcpServers\": {\n \"reviewwebsite\": {\n \"command\": \"node\",\n \"args\": [\"/path/to/reviewwebsite-mcp-server/dist/index.js\"],\n \"transportType\": \"stdio\"\n }\n }\n}\n```\n\n**For remote HTTP configuration:**\n```json\n{\n \"mcpServers\": {\n \"reviewwebsite\": {\n \"type\": \"http\",\n \"url\": \"http://localhost:8080/mcp\"\n }\n }\n}\n```\n\n**Environment Variables for HTTP Transport:**\n\nYou can configure the HTTP server using these environment variables:\n\n- `MCP_HTTP_HOST`: The host to bind to (default: `127.0.0.1`)\n- `MCP_HTTP_PORT`: The port to listen on (default: `8080`)\n- `MCP_HTTP_PATH`: The endpoint path (default: `/mcp`)\n\n---\n\n# Source Code Overview\n\n## What is MCP?\n\nModel Context Protocol (MCP) is an open standard that allows AI systems to securely and contextually connect with external tools and data sources.\n\nThis boilerplate implements the MCP specification with a clean, layered architecture that can be extended to build custom MCP servers for any API or data source.\n\n## Why Use This Boilerplate?\n\n- **Production-Ready Architecture**: Follows the same pattern used in published MCP servers, with clear separation between CLI, tools, controllers, and services.\n\n- **Type Safety**: Built with TypeScript for improved developer experience, code quality, and maintainability.\n\n- **Working Example**: Includes a fully implemented IP lookup tool demonstrating the complete pattern from CLI to API integration.\n\n- **Testing Framework**: Comes with testing infrastructure for both unit and CLI integration tests, including coverage reporting.\n\n- **Development Tooling**: Includes ESLint, Prettier, TypeScript, and other quality tools preconfigured for MCP server development.\n\n---\n\n# Getting Started\n\n## Prerequisites\n\n- **Node.js** (>=18.x): [Download](https://nodejs.org/)\n- **Git**: For version control\n\n---\n\n## Step 1: Clone and Install\n\n```bash\n# Clone the repository\ngit clone https://github.com/mrgoonie/reviewwebsite-mcp-server.git\ncd reviewwebsite-mcp-server\n\n# Install dependencies\nnpm install\n```\n\n---\n\n## Step 2: Run Development Server\n\nStart the server in development mode with stdio transport (default):\n\n```bash\nnpm run dev:server\n```\n\nOr with the Streamable HTTP transport:\n\n```bash\nnpm run dev:server:http\n```\n\nThis starts the MCP server with hot-reloading and enables the MCP Inspector at http://localhost:5173.\n\n⚙️ Proxy server listening on port 6277\n🔍 MCP Inspector is up and running at http://127.0.0.1:6274\n\nWhen using HTTP transport, the server will be available at http://127.0.0.1:8080/mcp by default.\n\n---\n\n## Step 3: Test the ReviewWebsite API Tools\n\nUse the ReviewWebsite API tools via CLI:\n\n```bash\n# Get available AI models\nnpm run dev:cli -- get-ai-models --api-key \"your-api-key\"\n\n# Create a review\nnpm run dev:cli -- create-review --url \"https://example.com\" --instructions \"Review this website\" --api-key \"your-api-key\"\n\n# Convert URL to Markdown\nnpm run dev:cli -- convert-to-markdown --url \"https://example.com\" --model \"gpt-4o\" --api-key \"your-api-key\"\n```\n\n---\n\n# Architecture\n\nThis boilerplate follows a clean, layered architecture pattern that separates concerns and promotes maintainability.\n\n## Project Structure\n\n```\nsrc/\n├── cli/ # Command-line interfaces\n├── controllers/ # Business logic\n├── resources/ # MCP resources: expose data and content from your servers to LLMs\n├── services/ # External API interactions\n├── tools/ # MCP tool definitions\n├── types/ # Type definitions\n├── utils/ # Shared utilities\n└── index.ts # Entry point\n```\n\n## Layers and Responsibilities\n\n### CLI Layer (`src/cli/*.cli.ts`)\n\n- **Purpose**: Define command-line interfaces that parse arguments and call controllers\n- **Naming**: Files should be named `.cli.ts`\n- **Testing**: CLI integration tests in `.cli.test.ts`\n\n### Tools Layer (`src/tools/*.tool.ts`)\n\n- **Purpose**: Define MCP tools with schemas and descriptions for AI assistants\n- **Naming**: Files should be named `.tool.ts` with types in `.types.ts`\n- **Pattern**: Each tool should use zod for argument validation\n\n### Controllers Layer (`src/controllers/*.controller.ts`)\n\n- **Purpose**: Implement business logic, handle errors, and format responses\n- **Naming**: Files should be named `.controller.ts`\n- **Pattern**: Should return standardized `ControllerResponse` objects\n\n### Services Layer (`src/services/*.service.ts`)\n\n- **Purpose**: Interact with external APIs or data sources\n- **Naming**: Files should be named `.service.ts`\n- **Pattern**: Pure API interactions with minimal logic\n\n### Utils Layer (`src/utils/*.util.ts`)\n\n- **Purpose**: Provide shared functionality across the application\n- **Key Utils**:\n - `logger.util.ts`: Structured logging\n - `error.util.ts`: Error handling and standardization\n - `formatter.util.ts`: Markdown formatting helpers\n\n---\n\n# Development Guide\n\n## Development Scripts\n\n```bash\n# Start server in development mode (hot-reload & inspector)\nnpm run dev:server\n\n# Run CLI in development mode\nnpm run dev:cli -- [command] [args]\n\n# Build the project\nnpm run build\n\n# Start server in production mode\nnpm run start:server\n\n# Run CLI in production mode\nnpm run start:cli -- [command] [args]\n```\n\n## Testing\n\n```bash\n# Run all tests\nnpm test\n\n# Run specific tests\nnpm test -- src/path/to/test.ts\n\n# Generate test coverage report\nnpm run test:coverage\n```\n\n## Code Quality\n\n```bash\n# Lint code\nnpm run lint\n\n# Format code with Prettier\nnpm run format\n\n# Check types\nnpm run typecheck\n```\n\n---\n\n# Building Custom Tools\n\nFollow these steps to add your own tools to the server:\n\n## 1. Define Service Layer\n\nCreate a new service in `src/services/` to interact with your external API:\n\n```typescript\n// src/services/example.service.ts\nimport { Logger } from '../utils/logger.util.js';\n\nconst logger = Logger.forContext('services/example.service.ts');\n\nexport async function getData(param: string): Promise {\n\tlogger.debug('Getting data', { param });\n\t// API interaction code here\n\treturn { result: 'example data' };\n}\n```\n\n## 2. Create Controller\n\nAdd a controller in `src/controllers/` to handle business logic:\n\n```typescript\n// src/controllers/example.controller.ts\nimport { Logger } from '../utils/logger.util.js';\nimport * as exampleService from '../services/example.service.js';\nimport { formatMarkdown } from '../utils/formatter.util.js';\nimport { handleControllerError } from '../utils/error-handler.util.js';\nimport { ControllerResponse } from '../types/common.types.js';\n\nconst logger = Logger.forContext('controllers/example.controller.ts');\n\nexport interface GetDataOptions {\n\tparam?: string;\n}\n\nexport async function getData(\n\toptions: GetDataOptions = {},\n): Promise {\n\ttry {\n\t\tlogger.debug('Getting data with options', options);\n\n\t\tconst data = await exampleService.getData(options.param || 'default');\n\n\t\tconst content = formatMarkdown(data);\n\n\t\treturn { content };\n\t} catch (error) {\n\t\tthrow handleControllerError(error, {\n\t\t\tentityType: 'ExampleData',\n\t\t\toperation: 'getData',\n\t\t\tsource: 'controllers/example.controller.ts',\n\t\t});\n\t}\n}\n```\n\n## 3. Implement MCP Tool\n\nCreate a tool definition in `src/tools/`:\n\n```typescript\n// src/tools/example.tool.ts\nimport { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport { z } from 'zod';\nimport { Logger } from '../utils/logger.util.js';\nimport { formatErrorForMcpTool } from '../utils/error.util.js';\nimport * as exampleController from '../controllers/example.controller.js';\n\nconst logger = Logger.forContext('tools/example.tool.ts');\n\nconst GetDataArgs = z.object({\n\tparam: z.string().optional().describe('Optional parameter'),\n});\n\ntype GetDataArgsType = z.infer;\n\nasync function handleGetData(args: GetDataArgsType) {\n\ttry {\n\t\tlogger.debug('Tool get_data called', args);\n\n\t\tconst result = await exampleController.getData({\n\t\t\tparam: args.param,\n\t\t});\n\n\t\treturn {\n\t\t\tcontent: [{ type: 'text' as const, text: result.content }],\n\t\t};\n\t} catch (error) {\n\t\tlogger.error('Tool get_data failed', error);\n\t\treturn formatErrorForMcpTool(error);\n\t}\n}\n\nexport function register(server: McpServer) {\n\tserver.tool(\n\t\t'get_data',\n\t\t`Gets data from the example API, optionally using \\`param\\`.\nUse this to fetch example data. Returns formatted data as Markdown.`,\n\t\tGetDataArgs.shape,\n\t\thandleGetData,\n\t);\n}\n```\n\n## 4. Add CLI Support\n\nCreate a CLI command in `src/cli/`:\n\n```typescript\n// src/cli/example.cli.ts\nimport { program } from 'commander';\nimport { Logger } from '../utils/logger.util.js';\nimport * as exampleController from '../controllers/example.controller.js';\nimport { handleCliError } from '../utils/error-handler.util.js';\n\nconst logger = Logger.forContext('cli/example.cli.ts');\n\nprogram\n\t.command('get-data')\n\t.description('Get example data')\n\t.option('--param ', 'Optional parameter')\n\t.action(async (options) => {\n\t\ttry {\n\t\t\tlogger.debug('CLI get-data called', options);\n\n\t\t\tconst result = await exampleController.getData({\n\t\t\t\tparam: options.param,\n\t\t\t});\n\n\t\t\tconsole.log(result.content);\n\t\t} catch (error) {\n\t\t\thandleCliError(error);\n\t\t}\n\t});\n```\n\n## 5. Register Components\n\nUpdate the entry points to register your new components:\n\n```typescript\n// In src/cli/index.ts\nimport '../cli/example.cli.js';\n\n// In src/index.ts (for the tool)\nimport exampleTool from './tools/example.tool.js';\n// Then in registerTools function:\nexampleTool.register(server);\n```\n\n---\n\n# Debugging Tools\n\n## MCP Inspector\n\nAccess the visual MCP Inspector to test your tools and view request/response details:\n\n1. Run `npm run dev:server`\n2. Open http://localhost:5173 in your browser\n3. Test your tools and view logs directly in the UI\n\n## Server Logs\n\nEnable debug logs for development:\n\n```bash\n# Set environment variable\nDEBUG=true npm run dev:server\n\n# Or configure in ~/.mcp/configs.json\n```\n\n---\n\n# Publishing Your MCP Server\n\nWhen ready to publish your custom MCP server:\n\n1. Update package.json with your details\n2. Update README.md with your tool documentation\n3. Build the project: `npm run build`\n4. Test the production build: `npm run start:server`\n5. Publish to npm: `npm publish`\n\n---\n\n# License\n\n[MIT License](https://opensource.org/licenses/MIT)\n\n```json\n{\n\t\"reviewwebsite\": {\n\t\t\"environments\": {\n\t\t\t\"DEBUG\": \"true\",\n\t\t\t\"REVIEWWEBSITE_API_KEY\": \"your-api-key-here\"\n\t\t}\n\t}\n}\n```\n\n**Note:** For backward compatibility, the server will also recognize configurations under the full package name (`reviewwebsite-mcp-server`) or the unscoped package name (`reviewwebsite-mcp-server`) if the `reviewwebsite` key is not found. However, using the short `reviewwebsite` key is recommended for new configurations.","English","en-US",{"_29":49,"_37":53,"_39":54},{"_31":50,"_33":51,"_35":52},"Servidor MCP que conecta a los asistentes de IA con la API de ReviewWebsite.com para crear y administrar reseñas de sitios web, extraer datos, convertir URL a Markdown e interactuar con contenido web.","Revisión del sitio web MCP Server","# ReviewWebsite.com - Servidor MCP\n\nEste proyecto proporciona un servidor de Protocolo de Contexto de Modelo (MCP) que conecta a los asistentes de IA con la API de [ReviewWebsite.com](https://reviewweb.site) para crear y administrar reseñas de sitios web, extraer datos, convertir URL a Markdown y más.\n\n* [Github](https://github.com/mrgoonie/reviewwebsite-mcp-server)\n* [NGP](https://www.npmjs.com/package/reviewwebsite-mcp-server)\n\n### Funciones disponibles\n\n* \\[x] Crear, leer, actualizar y eliminar reseñas de sitios web\n* \\[x] Obtenga modelos de IA disponibles\n* \\[x] Convertir URL a Markdown usando IA\n* \\[x] Extraer datos estructurados de URL mediante IA\n* \\[x] Extraer URL y contenido\n* \\[x] Extraer enlaces de sitios web\n* \\[x] Resumir URL y sitios web usando IA\n* \\[x] Información SEO (ideas de palabras clave, dificultad de palabras clave, análisis de tráfico, vínculos de retroceso)\n* \\[x] Personalizar modelos y parámetros de IA\n* \\[x] Controlar el comportamiento y el tiempo de espera\n\n## ReviewWeb.site\n\n* [Sitio web](https://reviewweb.site)\n* [Documentación de la API](https://reviewweb.site/api-docs/)\n* [Configuración de API Swagger](https://reviewweb.site/api-docs/swagger-ui-init.js)\n* Crea tu clave API [aquí](https://reviewweb.site/profile)\n\n## Transportes soportados\n\n* \\[x] Transporte [\"stdio\"](https://modelcontextprotocol.io/specification/2025-03-26/basic/transports#stdio) : transporte predeterminado para el uso de CLI\n* \\[x] Transporte[\"HTTP transmitible\"](https://modelcontextprotocol.io/specification/2025-03-26/basic/transports#streamable-http) : para clientes web\n * \\[ ] Implementar autenticación (encabezados \"Autorización\" con `Bearer ` )\n* \\[ ] ~~transporte \"sse\"~~ **[(Obsoleto)](https://modelcontextprotocol.io/specification/2025-03-26/basic/transports#backwards-compatibility)**\n* \\[ ] Escribir pruebas\n\n## Cómo utilizar\n\n### CLI\n\n```bash\n# Get available AI models\nnpm run dev:cli -- get-ai-models --api-key \"your-api-key\"\n\n# Create a new review\nnpm run dev:cli -- create-review --url \"https://example.com\" --instructions \"Review this website\" --api-key \"your-api-key\"\n\n# Get a specific review by ID\nnpm run dev:cli -- get-review --review-id \"review-id\" --api-key \"your-api-key\"\n\n# List all reviews\nnpm run dev:cli -- list-reviews --page 1 --limit 10 --api-key \"your-api-key\"\n\n# Update a review\nnpm run dev:cli -- update-review --review-id \"review-id\" --url \"https://example.com\" --instructions \"Updated instructions\" --api-key \"your-api-key\"\n\n# Delete a review\nnpm run dev:cli -- delete-review --review-id \"review-id\" --api-key \"your-api-key\"\n\n# Convert URL to Markdown\nnpm run dev:cli -- convert-to-markdown --url \"https://example.com\" --model \"gpt-4o\" --api-key \"your-api-key\"\n\n# Extract structured data from URL\nnpm run dev:cli -- extract-data --url \"https://example.com\" --instructions \"Extract product information\" --api-key \"your-api-key\"\n\n# Scrape URL\nnpm run dev:cli -- scrape-url --url \"https://example.com\" --api-key \"your-api-key\"\n\n# Extract links from URL\nnpm run dev:cli -- extract-links --url \"https://example.com\" --type \"all\" --api-key \"your-api-key\"\n\n# Summarize URL\nnpm run dev:cli -- summarize-url --url \"https://example.com\" --model \"gpt-4o\" --api-key \"your-api-key\"\n\n# Get keyword ideas for SEO\nnpm run dev:cli -- seo-keyword-ideas --keyword \"digital marketing\" --country \"us\" --search-engine \"Google\" --api-key \"your-api-key\"\n\n# Check keyword difficulty\nnpm run dev:cli -- seo-keyword-difficulty --keyword \"digital marketing\" --country \"us\" --api-key \"your-api-key\"\n\n# Analyze website traffic\nnpm run dev:cli -- seo-traffic --domain-or-url \"example.com\" --mode \"subdomains\" --country \"us\" --api-key \"your-api-key\"\n\n# Get backlinks for a domain\nnpm run dev:cli -- seo-backlinks --domain \"example.com\" --api-key \"your-api-key\"\n```\n\n### Configuración de MCP\n\n**Para la configuración local con transporte stdio:**\n\n```json\n{\n \"mcpServers\": {\n \"reviewwebsite\": {\n \"command\": \"node\",\n \"args\": [\"/path/to/reviewwebsite-mcp-server/dist/index.js\"],\n \"transportType\": \"stdio\"\n }\n }\n}\n```\n\n**Para la configuración HTTP remota:**\n\n```json\n{\n \"mcpServers\": {\n \"reviewwebsite\": {\n \"type\": \"http\",\n \"url\": \"http://localhost:8080/mcp\"\n }\n }\n}\n```\n\n**Variables de entorno para el transporte HTTP:**\n\nPuede configurar el servidor HTTP utilizando estas variables de entorno:\n\n* `MCP_HTTP_HOST` : El host al que vincularse (predeterminado: `127.0.0.1` )\n* `MCP_HTTP_PORT` : El puerto para escuchar (predeterminado: `8080` )\n* `MCP_HTTP_PATH` : La ruta del punto final (predeterminado: `/mcp` )\n\n***\n\n# Descripción general del código fuente\n\n## ¿Qué es MCP?\n\nEl Protocolo de Contexto de Modelo (MCP) es un estándar abierto que permite a los sistemas de IA conectarse de forma segura y contextual con herramientas y fuentes de datos externas.\n\nEsta plantilla implementa la especificación MCP con una arquitectura limpia y en capas que puede ampliarse para crear servidores MCP personalizados para cualquier API o fuente de datos.\n\n## ¿Por qué utilizar este texto estándar?\n\n* **Arquitectura lista para producción** : sigue el mismo patrón utilizado en los servidores MCP publicados, con una clara separación entre CLI, herramientas, controladores y servicios.\n\n* **Seguridad de tipos** : creado con TypeScript para mejorar la experiencia del desarrollador, la calidad del código y la facilidad de mantenimiento.\n\n* **Ejemplo de trabajo** : incluye una herramienta de búsqueda de IP completamente implementada que demuestra el patrón completo desde la CLI hasta la integración de API.\n\n* **Marco de pruebas** : incluye infraestructura de pruebas para pruebas de integración unitarias y CLI, incluidos informes de cobertura.\n\n* **Herramientas de desarrollo** : incluye ESLint, Prettier, TypeScript y otras herramientas de calidad preconfiguradas para el desarrollo de servidores MCP.\n\n***\n\n# Empezando\n\n## Prerrequisitos\n\n* **Node.js** (>=18.x): [Descargar](https://nodejs.org/)\n* **Git** : para el control de versiones\n\n***\n\n## Paso 1: Clonar e instalar\n\n```bash\n# Clone the repository\ngit clone https://github.com/mrgoonie/reviewwebsite-mcp-server.git\ncd reviewwebsite-mcp-server\n\n# Install dependencies\nnpm install\n```\n\n***\n\n## Paso 2: Ejecutar el servidor de desarrollo\n\nInicie el servidor en modo de desarrollo con el transporte stdio (predeterminado):\n\n```bash\nnpm run dev:server\n```\n\nO con el transporte HTTP Streamable:\n\n```bash\nnpm run dev:server:http\n```\n\nEsto inicia el servidor MCP con recarga activa y habilita el Inspector MCP en .\n\n⚙️ El servidor proxy escucha en el puerto 6277 🔍 MCP Inspector está en funcionamiento en \n\nAl utilizar el transporte HTTP, el servidor estará disponible en de forma predeterminada.\n\n***\n\n## Paso 3: Pruebe las herramientas de la API de ReviewWebsite\n\nUtilice las herramientas de la API de ReviewWebsite a través de CLI:\n\n```bash\n# Get available AI models\nnpm run dev:cli -- get-ai-models --api-key \"your-api-key\"\n\n# Create a review\nnpm run dev:cli -- create-review --url \"https://example.com\" --instructions \"Review this website\" --api-key \"your-api-key\"\n\n# Convert URL to Markdown\nnpm run dev:cli -- convert-to-markdown --url \"https://example.com\" --model \"gpt-4o\" --api-key \"your-api-key\"\n```\n\n***\n\n# Arquitectura\n\nEste modelo sigue un patrón de arquitectura limpio y en capas que separa las preocupaciones y promueve la capacidad de mantenimiento.\n\n## Estructura del proyecto\n\n```\nsrc/\n├── cli/ # Command-line interfaces\n├── controllers/ # Business logic\n├── resources/ # MCP resources: expose data and content from your servers to LLMs\n├── services/ # External API interactions\n├── tools/ # MCP tool definitions\n├── types/ # Type definitions\n├── utils/ # Shared utilities\n└── index.ts # Entry point\n```\n\n## Capas y responsabilidades\n\n### Capa CLI ( `src/cli/*.cli.ts` )\n\n* **Propósito** : Definir interfaces de línea de comandos que analizan argumentos y llaman a controladores.\n* **Nombre** : Los archivos deben llamarse `.cli.ts`\n* **Pruebas** : pruebas de integración de CLI en `.cli.test.ts`\n\n### Capa de herramientas ( `src/tools/*.tool.ts` )\n\n* **Propósito** : Definir herramientas MCP con esquemas y descripciones para asistentes de IA.\n* **Nombre** : Los archivos deben llamarse `.tool.ts` con tipos en `.types.ts`\n* **Patrón** : Cada herramienta debe usar zod para la validación de argumentos\n\n### Capa de controladores ( `src/controllers/*.controller.ts` )\n\n* **Propósito** : Implementar lógica empresarial, manejar errores y dar formato a respuestas.\n* **Nombre** : Los archivos deben llamarse `.controller.ts`\n* **Patrón** : Debe devolver objetos `ControllerResponse` estandarizados\n\n### Capa de servicios ( `src/services/*.service.ts` )\n\n* **Propósito** : Interactuar con API externas o fuentes de datos\n* **Nombre** : Los archivos deben llamarse `.service.ts`\n* **Patrón** : Interacciones de API puras con lógica mínima\n\n### Capa de utilidades ( `src/utils/*.util.ts` )\n\n* **Propósito** : Proporcionar funcionalidad compartida en toda la aplicación.\n* **Utilidades clave** :\n * `logger.util.ts` : Registro estructurado\n * `error.util.ts` : Manejo de errores y estandarización\n * `formatter.util.ts` : ayudantes de formato Markdown\n\n***\n\n# Guía de desarrollo\n\n## Scripts de desarrollo\n\n```bash\n# Start server in development mode (hot-reload & inspector)\nnpm run dev:server\n\n# Run CLI in development mode\nnpm run dev:cli -- [command] [args]\n\n# Build the project\nnpm run build\n\n# Start server in production mode\nnpm run start:server\n\n# Run CLI in production mode\nnpm run start:cli -- [command] [args]\n```\n\n## Pruebas\n\n```bash\n# Run all tests\nnpm test\n\n# Run specific tests\nnpm test -- src/path/to/test.ts\n\n# Generate test coverage report\nnpm run test:coverage\n```\n\n## Calidad del código\n\n```bash\n# Lint code\nnpm run lint\n\n# Format code with Prettier\nnpm run format\n\n# Check types\nnpm run typecheck\n```\n\n***\n\n# Creación de herramientas personalizadas\n\nSiga estos pasos para agregar sus propias herramientas al servidor:\n\n## 1. Definir la capa de servicio\n\nCree un nuevo servicio en `src/services/` para interactuar con su API externa:\n\n```typescript\n// src/services/example.service.ts\nimport { Logger } from '../utils/logger.util.js';\n\nconst logger = Logger.forContext('services/example.service.ts');\n\nexport async function getData(param: string): Promise {\n\tlogger.debug('Getting data', { param });\n\t// API interaction code here\n\treturn { result: 'example data' };\n}\n```\n\n## 2. Crear controlador\n\nAgregue un controlador en `src/controllers/` para manejar la lógica empresarial:\n\n```typescript\n// src/controllers/example.controller.ts\nimport { Logger } from '../utils/logger.util.js';\nimport * as exampleService from '../services/example.service.js';\nimport { formatMarkdown } from '../utils/formatter.util.js';\nimport { handleControllerError } from '../utils/error-handler.util.js';\nimport { ControllerResponse } from '../types/common.types.js';\n\nconst logger = Logger.forContext('controllers/example.controller.ts');\n\nexport interface GetDataOptions {\n\tparam?: string;\n}\n\nexport async function getData(\n\toptions: GetDataOptions = {},\n): Promise {\n\ttry {\n\t\tlogger.debug('Getting data with options', options);\n\n\t\tconst data = await exampleService.getData(options.param || 'default');\n\n\t\tconst content = formatMarkdown(data);\n\n\t\treturn { content };\n\t} catch (error) {\n\t\tthrow handleControllerError(error, {\n\t\t\tentityType: 'ExampleData',\n\t\t\toperation: 'getData',\n\t\t\tsource: 'controllers/example.controller.ts',\n\t\t});\n\t}\n}\n```\n\n## 3. Implementar la herramienta MCP\n\nCrea una definición de herramienta en `src/tools/` :\n\n```typescript\n// src/tools/example.tool.ts\nimport { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport { z } from 'zod';\nimport { Logger } from '../utils/logger.util.js';\nimport { formatErrorForMcpTool } from '../utils/error.util.js';\nimport * as exampleController from '../controllers/example.controller.js';\n\nconst logger = Logger.forContext('tools/example.tool.ts');\n\nconst GetDataArgs = z.object({\n\tparam: z.string().optional().describe('Optional parameter'),\n});\n\ntype GetDataArgsType = z.infer;\n\nasync function handleGetData(args: GetDataArgsType) {\n\ttry {\n\t\tlogger.debug('Tool get_data called', args);\n\n\t\tconst result = await exampleController.getData({\n\t\t\tparam: args.param,\n\t\t});\n\n\t\treturn {\n\t\t\tcontent: [{ type: 'text' as const, text: result.content }],\n\t\t};\n\t} catch (error) {\n\t\tlogger.error('Tool get_data failed', error);\n\t\treturn formatErrorForMcpTool(error);\n\t}\n}\n\nexport function register(server: McpServer) {\n\tserver.tool(\n\t\t'get_data',\n\t\t`Gets data from the example API, optionally using \\`param\\`.\nUse this to fetch example data. Returns formatted data as Markdown.`,\n\t\tGetDataArgs.shape,\n\t\thandleGetData,\n\t);\n}\n```\n\n## 4. Agregar compatibilidad con CLI\n\nCree un comando CLI en `src/cli/` :\n\n```typescript\n// src/cli/example.cli.ts\nimport { program } from 'commander';\nimport { Logger } from '../utils/logger.util.js';\nimport * as exampleController from '../controllers/example.controller.js';\nimport { handleCliError } from '../utils/error-handler.util.js';\n\nconst logger = Logger.forContext('cli/example.cli.ts');\n\nprogram\n\t.command('get-data')\n\t.description('Get example data')\n\t.option('--param ', 'Optional parameter')\n\t.action(async (options) => {\n\t\ttry {\n\t\t\tlogger.debug('CLI get-data called', options);\n\n\t\t\tconst result = await exampleController.getData({\n\t\t\t\tparam: options.param,\n\t\t\t});\n\n\t\t\tconsole.log(result.content);\n\t\t} catch (error) {\n\t\t\thandleCliError(error);\n\t\t}\n\t});\n```\n\n## 5. Registrar componentes\n\nActualice los puntos de entrada para registrar sus nuevos componentes:\n\n```typescript\n// In src/cli/index.ts\nimport '../cli/example.cli.js';\n\n// In src/index.ts (for the tool)\nimport exampleTool from './tools/example.tool.js';\n// Then in registerTools function:\nexampleTool.register(server);\n```\n\n***\n\n# Herramientas de depuración\n\n## Inspector de MCP\n\nAcceda al Inspector visual de MCP para probar sus herramientas y ver los detalles de la solicitud/respuesta:\n\n1. Ejecutar `npm run dev:server`\n2. Abra en su navegador\n3. Pruebe sus herramientas y vea los registros directamente en la interfaz de usuario\n\n## Registros del servidor\n\nHabilitar registros de depuración para el desarrollo:\n\n```bash\n# Set environment variable\nDEBUG=true npm run dev:server\n\n# Or configure in ~/.mcp/configs.json\n```\n\n***\n\n# Publicación de su servidor MCP\n\nCuando esté listo para publicar su servidor MCP personalizado:\n\n1. Actualice package.json con sus datos\n2. Actualice README.md con la documentación de su herramienta\n3. Construya el proyecto: `npm run build`\n4. Pruebe la compilación de producción: `npm run start:server`\n5. Publicar en npm: `npm publish`\n\n***\n\n# Licencia\n\n[Licencia MIT](https://opensource.org/licenses/MIT)\n\n```json\n{\n\t\"reviewwebsite\": {\n\t\t\"environments\": {\n\t\t\t\"DEBUG\": \"true\",\n\t\t\t\"REVIEWWEBSITE_API_KEY\": \"your-api-key-here\"\n\t\t}\n\t}\n}\n```\n\n**Nota:** Para compatibilidad con versiones anteriores, el servidor también reconocerá las configuraciones con el nombre completo del paquete ( `reviewwebsite-mcp-server` ) o con el nombre sin ámbito ( `reviewwebsite-mcp-server` ) si no se encuentra la clave `reviewwebsite` . Sin embargo, se recomienda usar la clave `reviewwebsite` corta para las nuevas configuraciones.","Spanish","es-ES",{"_29":56,"_37":60,"_39":61},{"_31":57,"_33":58,"_35":59},"AI アシスタントを ReviewWebsite.com API に接続し、Web サイトのレビューの作成と管理、データの抽出、URL のマークダウンへの変換、Web コンテンツの操作を行う MCP サーバー。","レビューウェブサイトMCPサーバー","# ReviewWebsite.com - MCP サーバー\n\nこのプロジェクトは、AI アシスタントを[ReviewWebsite.com](https://reviewweb.site) API に接続して、Web サイトのレビューの作成と管理、データの抽出、URL のマークダウンへの変換などを行うモデルコンテキストプロトコル (MCP) サーバーを提供します。\n\n* [ギットハブ](https://github.com/mrgoonie/reviewwebsite-mcp-server)\n* [国立博物館](https://www.npmjs.com/package/reviewwebsite-mcp-server)\n\n### 利用可能な機能\n\n* \\[x] ウェブサイトのレビューを作成、閲覧、更新、削除する\n* \\[x] 利用可能なAIモデルを取得する\n* \\[x] AIを使ってURLをMarkdownに変換する\n* \\[x] AIを使ってURLから構造化データを抽出する\n* \\[x] URLをスクレイピングしてコンテンツを抽出する\n* \\[x] ウェブサイトからリンクを抽出する\n* \\[x] AIを使ってURLとウェブサイトを要約する\n* \\[x] SEOインサイト（キーワードのアイデア、キーワードの難易度、トラフィック分析、バックリンク）\n* \\[x] AIモデルとパラメータをカスタマイズする\n* \\[x] 待機動作とタイミングを制御する\n\n## レビューWebサイト\n\n* [Webサイト](https://reviewweb.site)\n* [APIドキュメント](https://reviewweb.site/api-docs/)\n* [API Swagger 構成](https://reviewweb.site/api-docs/swagger-ui-init.js)\n* [ここで](https://reviewweb.site/profile)APIキーを作成してください\n\n## サポートされているトランスポート\n\n* \\[x] [\"stdio\"](https://modelcontextprotocol.io/specification/2025-03-26/basic/transports#stdio)トランスポート - CLI 使用時のデフォルトのトランスポート\n* \\[x][「ストリーミング可能なHTTP」](https://modelcontextprotocol.io/specification/2025-03-26/basic/transports#streamable-http)トランスポート - Webベースのクライアント向け\n * \\[ ] 認証を実装する（ `Bearer `を使用した「Authorization」ヘッダー）\n* \\[ ] ~~「sse」輸送~~**[(非推奨)](https://modelcontextprotocol.io/specification/2025-03-26/basic/transports#backwards-compatibility)**\n* \\[ ] テストを書く\n\n## 使い方\n\n### コマンドライン\n\n```bash\n# Get available AI models\nnpm run dev:cli -- get-ai-models --api-key \"your-api-key\"\n\n# Create a new review\nnpm run dev:cli -- create-review --url \"https://example.com\" --instructions \"Review this website\" --api-key \"your-api-key\"\n\n# Get a specific review by ID\nnpm run dev:cli -- get-review --review-id \"review-id\" --api-key \"your-api-key\"\n\n# List all reviews\nnpm run dev:cli -- list-reviews --page 1 --limit 10 --api-key \"your-api-key\"\n\n# Update a review\nnpm run dev:cli -- update-review --review-id \"review-id\" --url \"https://example.com\" --instructions \"Updated instructions\" --api-key \"your-api-key\"\n\n# Delete a review\nnpm run dev:cli -- delete-review --review-id \"review-id\" --api-key \"your-api-key\"\n\n# Convert URL to Markdown\nnpm run dev:cli -- convert-to-markdown --url \"https://example.com\" --model \"gpt-4o\" --api-key \"your-api-key\"\n\n# Extract structured data from URL\nnpm run dev:cli -- extract-data --url \"https://example.com\" --instructions \"Extract product information\" --api-key \"your-api-key\"\n\n# Scrape URL\nnpm run dev:cli -- scrape-url --url \"https://example.com\" --api-key \"your-api-key\"\n\n# Extract links from URL\nnpm run dev:cli -- extract-links --url \"https://example.com\" --type \"all\" --api-key \"your-api-key\"\n\n# Summarize URL\nnpm run dev:cli -- summarize-url --url \"https://example.com\" --model \"gpt-4o\" --api-key \"your-api-key\"\n\n# Get keyword ideas for SEO\nnpm run dev:cli -- seo-keyword-ideas --keyword \"digital marketing\" --country \"us\" --search-engine \"Google\" --api-key \"your-api-key\"\n\n# Check keyword difficulty\nnpm run dev:cli -- seo-keyword-difficulty --keyword \"digital marketing\" --country \"us\" --api-key \"your-api-key\"\n\n# Analyze website traffic\nnpm run dev:cli -- seo-traffic --domain-or-url \"example.com\" --mode \"subdomains\" --country \"us\" --api-key \"your-api-key\"\n\n# Get backlinks for a domain\nnpm run dev:cli -- seo-backlinks --domain \"example.com\" --api-key \"your-api-key\"\n```\n\n### MCPセットアップ\n\n**stdio トランスポートを使用したローカル構成の場合:**\n\n```json\n{\n \"mcpServers\": {\n \"reviewwebsite\": {\n \"command\": \"node\",\n \"args\": [\"/path/to/reviewwebsite-mcp-server/dist/index.js\"],\n \"transportType\": \"stdio\"\n }\n }\n}\n```\n\n**リモート HTTP 構成の場合:**\n\n```json\n{\n \"mcpServers\": {\n \"reviewwebsite\": {\n \"type\": \"http\",\n \"url\": \"http://localhost:8080/mcp\"\n }\n }\n}\n```\n\n**HTTP トランスポートの環境変数:**\n\n次の環境変数を使用して HTTP サーバーを構成できます。\n\n* `MCP_HTTP_HOST` : バインドするホスト（デフォルト: `127.0.0.1` ）\n* `MCP_HTTP_PORT` : リッスンするポート（デフォルト: `8080` ）\n* `MCP_HTTP_PATH` : エンドポイントパス（デフォルト: `/mcp` ）\n\n***\n\n# ソースコードの概要\n\n## MCPとは何ですか?\n\nモデルコンテキストプロトコル (MCP) は、AI システムが外部ツールやデータソースに安全かつコンテキストに応じて接続できるようにするオープンスタンダードです。\n\nこのボイラープレートは、任意の API またはデータソース用のカスタム MCP サーバーを構築するために拡張できる、クリーンな階層化アーキテクチャを使用して MCP 仕様を実装します。\n\n## この定型句を使用する理由\n\n* **実稼働対応アーキテクチャ**: 公開された MCP サーバーで使用されるのと同じパターンに従い、CLI、ツール、コントローラー、およびサービスが明確に分離されています。\n\n* **型の安全性**: 開発者エクスペリエンス、コード品質、保守性を向上させるために TypeScript を使用して構築されています。\n\n* **動作例**: CLI から API 統合までの完全なパターンを示す、完全に実装された IP 検索ツールが含まれています。\n\n* **テストフレームワーク**: カバレッジレポートを含む、ユニットテストと CLI 統合テストの両方のテストインフラストラクチャが付属しています。\n\n* **開発ツール**: ESLint、Prettier、TypeScript、および MCP サーバー開発用に事前構成されたその他の高品質ツールが含まれています。\n\n***\n\n# はじめる\n\n## 前提条件\n\n* **Node.js** (>=18.x):[ダウンロード](https://nodejs.org/)\n* **Git** : バージョン管理用\n\n***\n\n## ステップ1: クローンとインストール\n\n```bash\n# Clone the repository\ngit clone https://github.com/mrgoonie/reviewwebsite-mcp-server.git\ncd reviewwebsite-mcp-server\n\n# Install dependencies\nnpm install\n```\n\n***\n\n## ステップ2: 開発サーバーを実行する\n\nstdio トランスポートを使用して開発モードでサーバーを起動します (デフォルト)。\n\n```bash\nnpm run dev:server\n```\n\nまたは、ストリーミング可能な HTTP トランスポートを使用する場合:\n\n```bash\nnpm run dev:server:http\n```\n\nこれにより、ホットリロードで MCP サーバーが起動し、で MCP インスペクターが有効になります。\n\n⚙️ プロキシサーバーはポート 6277 で待機しています 🔍 MCP Inspector はで稼働しています\n\nHTTP トランスポートを使用する場合、サーバーはデフォルトでで利用できるようになります。\n\n***\n\n## ステップ3: ReviewWebsite APIツールをテストする\n\nCLI 経由で ReviewWebsite API ツールを使用します。\n\n```bash\n# Get available AI models\nnpm run dev:cli -- get-ai-models --api-key \"your-api-key\"\n\n# Create a review\nnpm run dev:cli -- create-review --url \"https://example.com\" --instructions \"Review this website\" --api-key \"your-api-key\"\n\n# Convert URL to Markdown\nnpm run dev:cli -- convert-to-markdown --url \"https://example.com\" --model \"gpt-4o\" --api-key \"your-api-key\"\n```\n\n***\n\n# 建築\n\nこのボイラープレートは、懸念事項を分離し、保守性を促進する、クリーンな階層化アーキテクチャパターンに従います。\n\n## プロジェクト構造\n\n```\nsrc/\n├── cli/ # Command-line interfaces\n├── controllers/ # Business logic\n├── resources/ # MCP resources: expose data and content from your servers to LLMs\n├── services/ # External API interactions\n├── tools/ # MCP tool definitions\n├── types/ # Type definitions\n├── utils/ # Shared utilities\n└── index.ts # Entry point\n```\n\n## 階層と責任\n\n### CLI レイヤー ( `src/cli/*.cli.ts` )\n\n* **目的**: 引数を解析してコントローラを呼び出すコマンドラインインターフェースを定義する\n* **命名**: ファイル名は`.cli.ts`とします\n* **テスト**: `.cli.test.ts`内の CLI 統合テスト\n\n### ツールレイヤー ( `src/tools/*.tool.ts` )\n\n* **目的**: AIアシスタント用のスキーマと説明を備えたMCPツールを定義する\n* **命名**: ファイルは`.tool.ts`という名前にし、型は`.types.ts`に記述します。\n* **パターン**: 各ツールは引数の検証に zod を使用する必要があります\n\n### コントローラーレイヤー ( `src/controllers/*.controller.ts` )\n\n* **目的**: ビジネスロジックを実装し、エラーを処理し、応答をフォーマットする\n* **命名**: ファイル名は`.controller.ts`とします\n* **パターン**: 標準化された`ControllerResponse`オブジェクトを返す必要があります\n\n### サービス層 ( `src/services/*.service.ts` )\n\n* **目的**: 外部APIまたはデータソースとのやり取り\n* **命名**: ファイル名は`.service.ts`とします\n* **パターン**: 最小限のロジックによる純粋な API のインタラクション\n\n### ユーティリティ層 ( `src/utils/*.util.ts` )\n\n* **目的**: アプリケーション全体で共有機能を提供する\n* **主なユーティリティ**:\n * `logger.util.ts` : 構造化ログ\n * `error.util.ts` : エラー処理と標準化\n * `formatter.util.ts` : Markdown フォーマットヘルパー\n\n***\n\n# 開発ガイド\n\n## 開発スクリプト\n\n```bash\n# Start server in development mode (hot-reload & inspector)\nnpm run dev:server\n\n# Run CLI in development mode\nnpm run dev:cli -- [command] [args]\n\n# Build the project\nnpm run build\n\n# Start server in production mode\nnpm run start:server\n\n# Run CLI in production mode\nnpm run start:cli -- [command] [args]\n```\n\n## テスト\n\n```bash\n# Run all tests\nnpm test\n\n# Run specific tests\nnpm test -- src/path/to/test.ts\n\n# Generate test coverage report\nnpm run test:coverage\n```\n\n## コード品質\n\n```bash\n# Lint code\nnpm run lint\n\n# Format code with Prettier\nnpm run format\n\n# Check types\nnpm run typecheck\n```\n\n***\n\n# カスタムツールの構築\n\n独自のツールをサーバーに追加するには、次の手順に従います。\n\n## 1. サービス層を定義する\n\n外部 API と対話するために`src/services/`に新しいサービスを作成します。\n\n```typescript\n// src/services/example.service.ts\nimport { Logger } from '../utils/logger.util.js';\n\nconst logger = Logger.forContext('services/example.service.ts');\n\nexport async function getData(param: string): Promise {\n\tlogger.debug('Getting data', { param });\n\t// API interaction code here\n\treturn { result: 'example data' };\n}\n```\n\n## 2. コントローラーを作成する\n\nビジネスロジックを処理するために、 `src/controllers/`にコントローラーを追加します。\n\n```typescript\n// src/controllers/example.controller.ts\nimport { Logger } from '../utils/logger.util.js';\nimport * as exampleService from '../services/example.service.js';\nimport { formatMarkdown } from '../utils/formatter.util.js';\nimport { handleControllerError } from '../utils/error-handler.util.js';\nimport { ControllerResponse } from '../types/common.types.js';\n\nconst logger = Logger.forContext('controllers/example.controller.ts');\n\nexport interface GetDataOptions {\n\tparam?: string;\n}\n\nexport async function getData(\n\toptions: GetDataOptions = {},\n): Promise {\n\ttry {\n\t\tlogger.debug('Getting data with options', options);\n\n\t\tconst data = await exampleService.getData(options.param || 'default');\n\n\t\tconst content = formatMarkdown(data);\n\n\t\treturn { content };\n\t} catch (error) {\n\t\tthrow handleControllerError(error, {\n\t\t\tentityType: 'ExampleData',\n\t\t\toperation: 'getData',\n\t\t\tsource: 'controllers/example.controller.ts',\n\t\t});\n\t}\n}\n```\n\n## 3. MCPツールを実装する\n\n`src/tools/`にツール定義を作成します。\n\n```typescript\n// src/tools/example.tool.ts\nimport { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport { z } from 'zod';\nimport { Logger } from '../utils/logger.util.js';\nimport { formatErrorForMcpTool } from '../utils/error.util.js';\nimport * as exampleController from '../controllers/example.controller.js';\n\nconst logger = Logger.forContext('tools/example.tool.ts');\n\nconst GetDataArgs = z.object({\n\tparam: z.string().optional().describe('Optional parameter'),\n});\n\ntype GetDataArgsType = z.infer;\n\nasync function handleGetData(args: GetDataArgsType) {\n\ttry {\n\t\tlogger.debug('Tool get_data called', args);\n\n\t\tconst result = await exampleController.getData({\n\t\t\tparam: args.param,\n\t\t});\n\n\t\treturn {\n\t\t\tcontent: [{ type: 'text' as const, text: result.content }],\n\t\t};\n\t} catch (error) {\n\t\tlogger.error('Tool get_data failed', error);\n\t\treturn formatErrorForMcpTool(error);\n\t}\n}\n\nexport function register(server: McpServer) {\n\tserver.tool(\n\t\t'get_data',\n\t\t`Gets data from the example API, optionally using \\`param\\`.\nUse this to fetch example data. Returns formatted data as Markdown.`,\n\t\tGetDataArgs.shape,\n\t\thandleGetData,\n\t);\n}\n```\n\n## 4. CLIサポートを追加する\n\n`src/cli/`に CLI コマンドを作成します。\n\n```typescript\n// src/cli/example.cli.ts\nimport { program } from 'commander';\nimport { Logger } from '../utils/logger.util.js';\nimport * as exampleController from '../controllers/example.controller.js';\nimport { handleCliError } from '../utils/error-handler.util.js';\n\nconst logger = Logger.forContext('cli/example.cli.ts');\n\nprogram\n\t.command('get-data')\n\t.description('Get example data')\n\t.option('--param ', 'Optional parameter')\n\t.action(async (options) => {\n\t\ttry {\n\t\t\tlogger.debug('CLI get-data called', options);\n\n\t\t\tconst result = await exampleController.getData({\n\t\t\t\tparam: options.param,\n\t\t\t});\n\n\t\t\tconsole.log(result.content);\n\t\t} catch (error) {\n\t\t\thandleCliError(error);\n\t\t}\n\t});\n```\n\n## 5. コンポーネントを登録する\n\n新しいコンポーネントを登録するには、エントリポイントを更新します。\n\n```typescript\n// In src/cli/index.ts\nimport '../cli/example.cli.js';\n\n// In src/index.ts (for the tool)\nimport exampleTool from './tools/example.tool.js';\n// Then in registerTools function:\nexampleTool.register(server);\n```\n\n***\n\n# デバッグツール\n\n## MCP検査官\n\nビジュアル MCP インスペクターにアクセスしてツールをテストし、リクエスト/レスポンスの詳細を表示します。\n\n1. `npm run dev:server`実行します。\n2. ブラウザでを開きます。\n3. ツールをテストし、UI で直接ログを表示します\n\n## サーバーログ\n\n開発用のデバッグログを有効にします。\n\n```bash\n# Set environment variable\nDEBUG=true npm run dev:server\n\n# Or configure in ~/.mcp/configs.json\n```\n\n***\n\n# MCPサーバーの公開\n\nカスタム MCP サーバーを公開する準備ができたら、次の手順を実行します。\n\n1. 詳細を記載したpackage.jsonを更新します\n2. ツールのドキュメントをREADME.mdに更新する\n3. プロジェクトをビルドします: `npm run build`\n4. 本番ビルドをテストする: `npm run start:server`\n5. npmに公開: `npm publish`\n\n***\n\n# ライセンス\n\n[MITライセンス](https://opensource.org/licenses/MIT)\n\n```json\n{\n\t\"reviewwebsite\": {\n\t\t\"environments\": {\n\t\t\t\"DEBUG\": \"true\",\n\t\t\t\"REVIEWWEBSITE_API_KEY\": \"your-api-key-here\"\n\t\t}\n\t}\n}\n```\n\n\\*\\*注:\\*\\*後方互換性のため、 `reviewwebsite`キーが見つからない場合、サーバーは完全なパッケージ名（ `reviewwebsite-mcp-server` ）またはスコープ外のパッケージ名（ `reviewwebsite-mcp-server` ）の設定も認識します。ただし、新しい設定では短縮形の`reviewwebsite`キーを使用することをお勧めします。","Japanese","ja-JP",{"_29":63,"_37":67,"_39":68},{"_31":64,"_33":65,"_35":66},"AI 어시스턴트를 ReviewWebsite.com API에 연결해 웹사이트 리뷰 작성 및 관리, 데이터 추출, URL을 마크다운으로 변환, 웹 콘텐츠와의 상호 작용을 지원하는 MCP 서버입니다.","리뷰웹사이트 MCP 서버","# ReviewWebsite.com - MCP 서버\n\n이 프로젝트는 AI 어시스턴트를 [ReviewWebsite.com](https://reviewweb.site) API에 연결하여 웹사이트 리뷰를 생성 및 관리하고, 데이터를 추출하고, URL을 마크다운으로 변환하는 등의 작업을 수행하는 MCP(Model Context Protocol) 서버를 제공합니다.\n\n* [깃허브](https://github.com/mrgoonie/reviewwebsite-mcp-server)\n* [국립민간공원](https://www.npmjs.com/package/reviewwebsite-mcp-server)\n\n### 사용 가능한 기능\n\n* \\[x] 웹사이트 리뷰 생성, 읽기, 업데이트 및 삭제\n* \\[x] 사용 가능한 AI 모델 가져오기\n* \\[x] AI를 사용하여 URL을 마크다운으로 변환\n* \\[x] AI를 사용하여 URL에서 구조화된 데이터 추출\n* \\[x] URL 스크래핑 및 콘텐츠 추출\n* \\[x] 웹사이트에서 링크 추출\n* \\[x] AI를 활용한 URL 및 웹사이트 요약\n* \\[x] SEO 통찰력(키워드 아이디어, 키워드 난이도, 트래픽 분석, 백링크)\n* \\[x] AI 모델 및 매개변수 사용자 정의\n* \\[x] 대기 동작 및 타이밍 제어\n\n## 리뷰웹사이트\n\n* [웹사이트](https://reviewweb.site)\n* [API 문서](https://reviewweb.site/api-docs/)\n* [API Swagger 구성](https://reviewweb.site/api-docs/swagger-ui-init.js)\n* [여기에서](https://reviewweb.site/profile) API 키를 생성하세요\n\n## 지원되는 전송\n\n* \\[x] [\"stdio\"](https://modelcontextprotocol.io/specification/2025-03-26/basic/transports#stdio) 전송 - CLI 사용을 위한 기본 전송\n* \\[x][\"스트리밍 가능한 HTTP\"](https://modelcontextprotocol.io/specification/2025-03-26/basic/transports#streamable-http) 전송 - 웹 기반 클라이언트용\n * \\[ ] `Bearer ` 포함한 auth(\"Authorization\" 헤더) 구현\n* \\[ ] ~~\"sse\" 운송~~ **[(더 이상 사용되지 않음)](https://modelcontextprotocol.io/specification/2025-03-26/basic/transports#backwards-compatibility)**\n* \\[ ] 테스트 작성\n\n## 사용 방법\n\n### CLI\n\n지엑스피1\n\n### MCP 설정\n\n**stdio 전송을 통한 로컬 구성의 경우:**\n\n```json\n{\n \"mcpServers\": {\n \"reviewwebsite\": {\n \"command\": \"node\",\n \"args\": [\"/path/to/reviewwebsite-mcp-server/dist/index.js\"],\n \"transportType\": \"stdio\"\n }\n }\n}\n```\n\n**원격 HTTP 구성의 경우:**\n\n```json\n{\n \"mcpServers\": {\n \"reviewwebsite\": {\n \"type\": \"http\",\n \"url\": \"http://localhost:8080/mcp\"\n }\n }\n}\n```\n\n**HTTP 전송을 위한 환경 변수:**\n\n다음 환경 변수를 사용하여 HTTP 서버를 구성할 수 있습니다.\n\n* `MCP_HTTP_HOST` : 바인딩할 호스트(기본값: `127.0.0.1` )\n* `MCP_HTTP_PORT` : 수신할 포트(기본값: `8080` )\n* `MCP_HTTP_PATH` : 엔드포인트 경로(기본값: `/mcp` )\n\n***\n\n# 소스 코드 개요\n\n## MCP란 무엇인가요?\n\nMCP(Model Context Protocol)는 AI 시스템이 외부 도구 및 데이터 소스와 안전하고 상황에 맞게 연결할 수 있도록 하는 개방형 표준입니다.\n\n이 보일러플레이트는 모든 API나 데이터 소스에 대한 사용자 정의 MCP 서버를 구축하기 위해 확장 가능한 깔끔하고 계층화된 아키텍처로 MCP 사양을 구현합니다.\n\n## 왜 이 보일러플레이트를 사용해야 하나요?\n\n* **프로덕션 준비 아키텍처** : CLI, 도구, 컨트롤러 및 서비스를 명확하게 구분하여 게시된 MCP 서버에서 사용되는 것과 동일한 패턴을 따릅니다.\n\n* **유형 안전성** : 개발자 경험, 코드 품질, 유지 관리 용이성을 개선하기 위해 TypeScript로 구축되었습니다.\n\n* **실제 예제** : CLI에서 API 통합까지의 전체 패턴을 보여주는 완전히 구현된 IP 조회 도구가 포함되어 있습니다.\n\n* **테스트 프레임워크** : 커버리지 보고를 포함하여 단위 및 CLI 통합 테스트를 위한 테스트 인프라가 제공됩니다.\n\n* **개발 도구** : MCP 서버 개발을 위해 사전 구성된 ESLint, Prettier, TypeScript 및 기타 고품질 도구가 포함되어 있습니다.\n\n***\n\n# 시작하기\n\n## 필수 조건\n\n* **Node.js** (>=18.x): [다운로드](https://nodejs.org/)\n* **Git** : 버전 제어를 위해\n\n***\n\n## 1단계: 복제 및 설치\n\n```bash\n# Clone the repository\ngit clone https://github.com/mrgoonie/reviewwebsite-mcp-server.git\ncd reviewwebsite-mcp-server\n\n# Install dependencies\nnpm install\n```\n\n***\n\n## 2단계: 개발 서버 실행\n\nstdio 전송(기본값)을 사용하여 개발 모드로 서버를 시작합니다.\n\n```bash\nnpm run dev:server\n```\n\n또는 Streamable HTTP 전송을 사용하면:\n\n```bash\nnpm run dev:server:http\n```\n\n이렇게 하면 핫 리로딩으로 MCP 서버가 시작되고 에서 MCP 검사기가 활성화됩니다.\n\n⚙️ 포트 6277에서 수신 중인 프록시 서버 🔍 MCP Inspector가 에서 실행 중입니다.\n\nHTTP 전송을 사용하는 경우 서버는 기본적으로 에서 사용할 수 있습니다.\n\n***\n\n## 3단계: ReviewWebsite API 도구 테스트\n\nCLI를 통해 ReviewWebsite API 도구를 사용하세요.\n\n```bash\n# Get available AI models\nnpm run dev:cli -- get-ai-models --api-key \"your-api-key\"\n\n# Create a review\nnpm run dev:cli -- create-review --url \"https://example.com\" --instructions \"Review this website\" --api-key \"your-api-key\"\n\n# Convert URL to Markdown\nnpm run dev:cli -- convert-to-markdown --url \"https://example.com\" --model \"gpt-4o\" --api-key \"your-api-key\"\n```\n\n***\n\n# 건축학\n\n이 보일러플레이트는 관심사를 분리하고 유지 관리를 용이하게 하는 깔끔하고 계층화된 아키텍처 패턴을 따릅니다.\n\n## 프로젝트 구조\n\n```\nsrc/\n├── cli/ # Command-line interfaces\n├── controllers/ # Business logic\n├── resources/ # MCP resources: expose data and content from your servers to LLMs\n├── services/ # External API interactions\n├── tools/ # MCP tool definitions\n├── types/ # Type definitions\n├── utils/ # Shared utilities\n└── index.ts # Entry point\n```\n\n## 계층 및 책임\n\n### CLI 계층( `src/cli/*.cli.ts` )\n\n* **목적** : 인수를 구문 분석하고 컨트롤러를 호출하는 명령줄 인터페이스를 정의합니다.\n* **이름 지정** : 파일 이름은 `.cli.ts` 여야 합니다.\n* **테스트** : `.cli.test.ts` 의 CLI 통합 테스트\n\n### 도구 레이어( `src/tools/*.tool.ts` )\n\n* **목적** : AI 어시스턴트에 대한 스키마와 설명을 포함하는 MCP 도구 정의\n* **이름 지정** : 파일 이름은 `.tool.ts` 이고 유형은 `.types.ts` 입니다.\n* **패턴** : 각 도구는 인수 검증을 위해 zod를 사용해야 합니다.\n\n### 컨트롤러 레이어( `src/controllers/*.controller.ts` )\n\n* **목적** : 비즈니스 로직 구현, 오류 처리 및 응답 형식 지정\n* **이름 지정** : 파일 이름은 `.controller.ts` 여야 합니다.\n* **패턴** : 표준화된 `ControllerResponse` 객체를 반환해야 함\n\n### 서비스 계층( `src/services/*.service.ts` )\n\n* **목적** : 외부 API 또는 데이터 소스와 상호 작용\n* **이름 지정** : 파일 이름은 `.service.ts` 여야 합니다.\n* **패턴** : 최소한의 논리를 갖춘 순수 API 상호 작용\n\n### 유틸리티 레이어( `src/utils/*.util.ts` )\n\n* **목적** : 애플리케이션 전반에 걸쳐 공유 기능 제공\n* **주요 유틸리티** :\n * `logger.util.ts` : 구조화된 로깅\n * `error.util.ts` : 오류 처리 및 표준화\n * `formatter.util.ts` : 마크다운 서식 도우미\n\n***\n\n# 개발 가이드\n\n## 개발 스크립트\n\n```bash\n# Start server in development mode (hot-reload & inspector)\nnpm run dev:server\n\n# Run CLI in development mode\nnpm run dev:cli -- [command] [args]\n\n# Build the project\nnpm run build\n\n# Start server in production mode\nnpm run start:server\n\n# Run CLI in production mode\nnpm run start:cli -- [command] [args]\n```\n\n## 테스트\n\n```bash\n# Run all tests\nnpm test\n\n# Run specific tests\nnpm test -- src/path/to/test.ts\n\n# Generate test coverage report\nnpm run test:coverage\n```\n\n## 코드 품질\n\n```bash\n# Lint code\nnpm run lint\n\n# Format code with Prettier\nnpm run format\n\n# Check types\nnpm run typecheck\n```\n\n***\n\n# 사용자 정의 도구 구축\n\n서버에 자신의 도구를 추가하려면 다음 단계를 따르세요.\n\n## 1. 서비스 계층 정의\n\n외부 API와 상호 작용하려면 `src/services/` 에 새 서비스를 만드세요.\n\n```typescript\n// src/services/example.service.ts\nimport { Logger } from '../utils/logger.util.js';\n\nconst logger = Logger.forContext('services/example.service.ts');\n\nexport async function getData(param: string): Promise {\n\tlogger.debug('Getting data', { param });\n\t// API interaction code here\n\treturn { result: 'example data' };\n}\n```\n\n## 2. 컨트롤러 생성\n\n비즈니스 로직을 처리하기 위해 `src/controllers/` 에 컨트롤러를 추가합니다.\n\n```typescript\n// src/controllers/example.controller.ts\nimport { Logger } from '../utils/logger.util.js';\nimport * as exampleService from '../services/example.service.js';\nimport { formatMarkdown } from '../utils/formatter.util.js';\nimport { handleControllerError } from '../utils/error-handler.util.js';\nimport { ControllerResponse } from '../types/common.types.js';\n\nconst logger = Logger.forContext('controllers/example.controller.ts');\n\nexport interface GetDataOptions {\n\tparam?: string;\n}\n\nexport async function getData(\n\toptions: GetDataOptions = {},\n): Promise {\n\ttry {\n\t\tlogger.debug('Getting data with options', options);\n\n\t\tconst data = await exampleService.getData(options.param || 'default');\n\n\t\tconst content = formatMarkdown(data);\n\n\t\treturn { content };\n\t} catch (error) {\n\t\tthrow handleControllerError(error, {\n\t\t\tentityType: 'ExampleData',\n\t\t\toperation: 'getData',\n\t\t\tsource: 'controllers/example.controller.ts',\n\t\t});\n\t}\n}\n```\n\n## 3. MCP 도구 구현\n\n`src/tools/` 에 도구 정의를 생성합니다.\n\n```typescript\n// src/tools/example.tool.ts\nimport { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport { z } from 'zod';\nimport { Logger } from '../utils/logger.util.js';\nimport { formatErrorForMcpTool } from '../utils/error.util.js';\nimport * as exampleController from '../controllers/example.controller.js';\n\nconst logger = Logger.forContext('tools/example.tool.ts');\n\nconst GetDataArgs = z.object({\n\tparam: z.string().optional().describe('Optional parameter'),\n});\n\ntype GetDataArgsType = z.infer;\n\nasync function handleGetData(args: GetDataArgsType) {\n\ttry {\n\t\tlogger.debug('Tool get_data called', args);\n\n\t\tconst result = await exampleController.getData({\n\t\t\tparam: args.param,\n\t\t});\n\n\t\treturn {\n\t\t\tcontent: [{ type: 'text' as const, text: result.content }],\n\t\t};\n\t} catch (error) {\n\t\tlogger.error('Tool get_data failed', error);\n\t\treturn formatErrorForMcpTool(error);\n\t}\n}\n\nexport function register(server: McpServer) {\n\tserver.tool(\n\t\t'get_data',\n\t\t`Gets data from the example API, optionally using \\`param\\`.\nUse this to fetch example data. Returns formatted data as Markdown.`,\n\t\tGetDataArgs.shape,\n\t\thandleGetData,\n\t);\n}\n```\n\n## 4. CLI 지원 추가\n\n`src/cli/` 에 CLI 명령을 생성합니다.\n\n```typescript\n// src/cli/example.cli.ts\nimport { program } from 'commander';\nimport { Logger } from '../utils/logger.util.js';\nimport * as exampleController from '../controllers/example.controller.js';\nimport { handleCliError } from '../utils/error-handler.util.js';\n\nconst logger = Logger.forContext('cli/example.cli.ts');\n\nprogram\n\t.command('get-data')\n\t.description('Get example data')\n\t.option('--param ', 'Optional parameter')\n\t.action(async (options) => {\n\t\ttry {\n\t\t\tlogger.debug('CLI get-data called', options);\n\n\t\t\tconst result = await exampleController.getData({\n\t\t\t\tparam: options.param,\n\t\t\t});\n\n\t\t\tconsole.log(result.content);\n\t\t} catch (error) {\n\t\t\thandleCliError(error);\n\t\t}\n\t});\n```\n\n## 5. 구성 요소 등록\n\n새 구성 요소를 등록하려면 진입점을 업데이트하세요.\n\n```typescript\n// In src/cli/index.ts\nimport '../cli/example.cli.js';\n\n// In src/index.ts (for the tool)\nimport exampleTool from './tools/example.tool.js';\n// Then in registerTools function:\nexampleTool.register(server);\n```\n\n***\n\n# 디버깅 도구\n\n## MCP 검사관\n\n시각적 MCP 검사기에 액세스하여 도구를 테스트하고 요청/응답 세부 정보를 확인하세요.\n\n1. `npm run dev:server`\n2. 브라우저에서 [http://localhost:5173을](http://localhost:5173) 엽니다.\n3. UI에서 직접 도구를 테스트하고 로그를 확인하세요\n\n## 서버 로그\n\n개발을 위한 디버그 로그 활성화:\n\n```bash\n# Set environment variable\nDEBUG=true npm run dev:server\n\n# Or configure in ~/.mcp/configs.json\n```\n\n***\n\n# MCP 서버 게시\n\n사용자 정의 MCP 서버를 게시할 준비가 되면:\n\n1. package.json을 귀하의 세부 정보로 업데이트하세요\n2. 도구 설명서로 README.md를 업데이트하세요.\n3. 프로젝트 빌드: `npm run build`\n4. 프로덕션 빌드 테스트: `npm run start:server`\n5. npm에 게시: `npm publish`\n\n***\n\n# 특허\n\n[MIT 라이센스](https://opensource.org/licenses/MIT)\n\n```json\n{\n\t\"reviewwebsite\": {\n\t\t\"environments\": {\n\t\t\t\"DEBUG\": \"true\",\n\t\t\t\"REVIEWWEBSITE_API_KEY\": \"your-api-key-here\"\n\t\t}\n\t}\n}\n```\n\n**참고:** 이전 버전과의 호환성을 위해, 서버는 `reviewwebsite` 키가 없는 경우 전체 패키지 이름( `reviewwebsite-mcp-server` ) 또는 범위가 지정되지 않은 패키지 이름( `reviewwebsite-mcp-server` )의 구성도 인식합니다. 하지만 새로운 구성에는 짧은 `reviewwebsite` 키를 사용하는 것이 좋습니다.","Korean","ko-KR",{"_29":70,"_37":74,"_39":75},{"_31":71,"_33":72,"_35":73},"Сервер MCP, который подключает помощников на основе искусственного интеллекта к API ReviewWebsite.com для создания и управления обзорами веб-сайтов, извлечения данных, преобразования URL-адресов в разметку и взаимодействия с веб-контентом.","ОбзорВеб-сайта MCP Server","# ReviewWebsite.com - MCP-сервер\n\nЭтот проект предоставляет сервер Model Context Protocol (MCP), который подключает помощников на основе искусственного интеллекта к API [ReviewWebsite.com](https://reviewweb.site) для создания и управления обзорами веб-сайтов, извлечения данных, преобразования URL-адресов в разметку и многого другого.\n\n* [Гитхаб](https://github.com/mrgoonie/reviewwebsite-mcp-server)\n* [НПМ](https://www.npmjs.com/package/reviewwebsite-mcp-server)\n\n### Доступные функции\n\n* \\[x] Создание, чтение, обновление и удаление обзоров веб-сайтов\n* \\[x] Получить доступные модели ИИ\n* \\[x] Преобразование URL-адресов в Markdown с помощью ИИ\n* \\[x] Извлечение структурированных данных из URL-адресов с помощью ИИ\n* \\[x] Собирайте URL-адреса и извлекайте содержимое\n* \\[x] Извлечение ссылок с веб-сайтов\n* \\[x] Обобщение URL-адресов и веб-сайтов с помощью ИИ\n* \\[x] SEO-анализ (идеи ключевых слов, сложность ключевых слов, анализ трафика, обратные ссылки)\n* \\[x] Настройка моделей и параметров ИИ\n* \\[x] Управление поведением и временем ожидания\n\n## ОбзорWeb.site\n\n* [Веб-сайт](https://reviewweb.site)\n* [API-документы](https://reviewweb.site/api-docs/)\n* [Конфигурация API Swagger](https://reviewweb.site/api-docs/swagger-ui-init.js)\n* Создайте свой ключ API [здесь](https://reviewweb.site/profile)\n\n## Поддерживаемые транспорты\n\n* \\[x] [\"stdio\"](https://modelcontextprotocol.io/specification/2025-03-26/basic/transports#stdio) transport — транспорт по умолчанию для использования CLI\n* \\[x] Транспорт[«Streamable HTTP»](https://modelcontextprotocol.io/specification/2025-03-26/basic/transports#streamable-http) — для веб-клиентов\n * \\[ ] Реализовать аутентификацию (заголовки «Authorization» с `Bearer ` )\n* \\[ ] ~~\"sse\" транспорт~~ **[(Устаревшее)](https://modelcontextprotocol.io/specification/2025-03-26/basic/transports#backwards-compatibility)**\n* \\[ ] Написать тесты\n\n## Как использовать\n\n### CLI\n\n```bash\n# Get available AI models\nnpm run dev:cli -- get-ai-models --api-key \"your-api-key\"\n\n# Create a new review\nnpm run dev:cli -- create-review --url \"https://example.com\" --instructions \"Review this website\" --api-key \"your-api-key\"\n\n# Get a specific review by ID\nnpm run dev:cli -- get-review --review-id \"review-id\" --api-key \"your-api-key\"\n\n# List all reviews\nnpm run dev:cli -- list-reviews --page 1 --limit 10 --api-key \"your-api-key\"\n\n# Update a review\nnpm run dev:cli -- update-review --review-id \"review-id\" --url \"https://example.com\" --instructions \"Updated instructions\" --api-key \"your-api-key\"\n\n# Delete a review\nnpm run dev:cli -- delete-review --review-id \"review-id\" --api-key \"your-api-key\"\n\n# Convert URL to Markdown\nnpm run dev:cli -- convert-to-markdown --url \"https://example.com\" --model \"gpt-4o\" --api-key \"your-api-key\"\n\n# Extract structured data from URL\nnpm run dev:cli -- extract-data --url \"https://example.com\" --instructions \"Extract product information\" --api-key \"your-api-key\"\n\n# Scrape URL\nnpm run dev:cli -- scrape-url --url \"https://example.com\" --api-key \"your-api-key\"\n\n# Extract links from URL\nnpm run dev:cli -- extract-links --url \"https://example.com\" --type \"all\" --api-key \"your-api-key\"\n\n# Summarize URL\nnpm run dev:cli -- summarize-url --url \"https://example.com\" --model \"gpt-4o\" --api-key \"your-api-key\"\n\n# Get keyword ideas for SEO\nnpm run dev:cli -- seo-keyword-ideas --keyword \"digital marketing\" --country \"us\" --search-engine \"Google\" --api-key \"your-api-key\"\n\n# Check keyword difficulty\nnpm run dev:cli -- seo-keyword-difficulty --keyword \"digital marketing\" --country \"us\" --api-key \"your-api-key\"\n\n# Analyze website traffic\nnpm run dev:cli -- seo-traffic --domain-or-url \"example.com\" --mode \"subdomains\" --country \"us\" --api-key \"your-api-key\"\n\n# Get backlinks for a domain\nnpm run dev:cli -- seo-backlinks --domain \"example.com\" --api-key \"your-api-key\"\n```\n\n### Настройка МКП\n\n**Для локальной конфигурации с транспортом stdio:**\n\n```json\n{\n \"mcpServers\": {\n \"reviewwebsite\": {\n \"command\": \"node\",\n \"args\": [\"/path/to/reviewwebsite-mcp-server/dist/index.js\"],\n \"transportType\": \"stdio\"\n }\n }\n}\n```\n\n**Для удаленной конфигурации HTTP:**\n\n```json\n{\n \"mcpServers\": {\n \"reviewwebsite\": {\n \"type\": \"http\",\n \"url\": \"http://localhost:8080/mcp\"\n }\n }\n}\n```\n\n**Переменные среды для HTTP-транспорта:**\n\nВы можете настроить HTTP-сервер, используя следующие переменные среды:\n\n* `MCP_HTTP_HOST` : Хост для привязки (по умолчанию: `127.0.0.1` )\n* `MCP_HTTP_PORT` : Порт для прослушивания (по умолчанию: `8080` )\n* `MCP_HTTP_PATH` : Путь к конечной точке (по умолчанию: `/mcp` )\n\n***\n\n# Обзор исходного кода\n\n## Что такое МКП?\n\nModel Context Protocol (MCP) — открытый стандарт, позволяющий системам искусственного интеллекта безопасно и контекстно подключаться к внешним инструментам и источникам данных.\n\nЭтот шаблон реализует спецификацию MCP с помощью чистой многоуровневой архитектуры, которую можно расширить для создания пользовательских серверов MCP для любого API или источника данных.\n\n## Зачем использовать этот шаблон?\n\n* **Архитектура, готовая к производству** : следует той же схеме, которая используется в опубликованных серверах MCP, с четким разделением между CLI, инструментами, контроллерами и службами.\n\n* **Безопасность типов** : создано с использованием TypeScript для улучшения опыта разработки, качества кода и удобства обслуживания.\n\n* **Рабочий пример** : включает в себя полностью реализованный инструмент поиска IP-адресов, демонстрирующий полную модель от CLI до интеграции API.\n\n* **Тестовая среда** : поставляется с тестовой инфраструктурой для модульных и интеграционных тестов CLI, включая отчеты о покрытии.\n\n* **Инструменты разработки** : включают ESLint, Prettier, TypeScript и другие качественные инструменты, предварительно настроенные для разработки сервера MCP.\n\n***\n\n# Начиная\n\n## Предпосылки\n\n* **Node.js** (>=18.x): [Загрузить](https://nodejs.org/)\n* **Git** : для контроля версий\n\n***\n\n## Шаг 1: Клонирование и установка\n\n```bash\n# Clone the repository\ngit clone https://github.com/mrgoonie/reviewwebsite-mcp-server.git\ncd reviewwebsite-mcp-server\n\n# Install dependencies\nnpm install\n```\n\n***\n\n## Шаг 2: Запуск сервера разработки\n\nЗапустите сервер в режиме разработки с использованием транспорта stdio (по умолчанию):\n\n```bash\nnpm run dev:server\n```\n\nИли с помощью потокового HTTP-транспорта:\n\n```bash\nnpm run dev:server:http\n```\n\nЭто запустит сервер MCP с горячей перезагрузкой и включит MCP Inspector по адресу .\n\n⚙️ Прокси-сервер прослушивает порт 6277 🔍 MCP Inspector запущен и работает по адресу \n\nПри использовании HTTP-транспорта сервер по умолчанию будет доступен по адресу .\n\n***\n\n## Шаг 3: Тестирование API-инструментов ReviewWebsite\n\nИспользуйте инструменты API ReviewWebsite через CLI:\n\n```bash\n# Get available AI models\nnpm run dev:cli -- get-ai-models --api-key \"your-api-key\"\n\n# Create a review\nnpm run dev:cli -- create-review --url \"https://example.com\" --instructions \"Review this website\" --api-key \"your-api-key\"\n\n# Convert URL to Markdown\nnpm run dev:cli -- convert-to-markdown --url \"https://example.com\" --model \"gpt-4o\" --api-key \"your-api-key\"\n```\n\n***\n\n# Архитектура\n\nЭтот шаблон следует четкой, многоуровневой архитектурной модели, которая разделяет проблемы и способствует удобству обслуживания.\n\n## Структура проекта\n\n```\nsrc/\n├── cli/ # Command-line interfaces\n├── controllers/ # Business logic\n├── resources/ # MCP resources: expose data and content from your servers to LLMs\n├── services/ # External API interactions\n├── tools/ # MCP tool definitions\n├── types/ # Type definitions\n├── utils/ # Shared utilities\n└── index.ts # Entry point\n```\n\n## Уровни и обязанности\n\n### Уровень CLI ( `src/cli/*.cli.ts` )\n\n* **Цель** : определение интерфейсов командной строки, которые анализируют аргументы и вызывают контроллеры.\n* **Именование** : Файлы должны называться `.cli.ts`\n* **Тестирование** : тесты интеграции CLI в `.cli.test.ts`\n\n### Слой инструментов ( `src/tools/*.tool.ts` )\n\n* **Цель** : Определить инструменты MCP со схемами и описаниями для помощников ИИ.\n* **Именование** : файлы должны иметь имена `.tool.ts` с типами в `.types.ts`\n* **Шаблон** : Каждый инструмент должен использовать zod для проверки аргументов.\n\n### Уровень контроллеров ( `src/controllers/*.controller.ts` )\n\n* **Цель** : Реализация бизнес-логики, обработка ошибок и форматирование ответов.\n* **Именование** : Файлы должны называться `.controller.ts`\n* **Шаблон** : Должен возвращать стандартизированные объекты `ControllerResponse`\n\n### Уровень служб ( `src/services/*.service.ts` )\n\n* **Цель** : Взаимодействие с внешними API или источниками данных.\n* **Именование** : Файлы должны называться `.service.ts`\n* **Шаблон** : чистое взаимодействие API с минимальной логикой\n\n### Уровень утилит ( `src/utils/*.util.ts` )\n\n* **Цель** : Обеспечить общую функциональность для всего приложения.\n* **Ключевые возможности** :\n * `logger.util.ts` : Структурированное ведение журнала\n * `error.util.ts` : Обработка ошибок и стандартизация\n * `formatter.util.ts` : Помощники форматирования Markdown\n\n***\n\n# Руководство по разработке\n\n## Сценарии разработки\n\n```bash\n# Start server in development mode (hot-reload & inspector)\nnpm run dev:server\n\n# Run CLI in development mode\nnpm run dev:cli -- [command] [args]\n\n# Build the project\nnpm run build\n\n# Start server in production mode\nnpm run start:server\n\n# Run CLI in production mode\nnpm run start:cli -- [command] [args]\n```\n\n## Тестирование\n\n```bash\n# Run all tests\nnpm test\n\n# Run specific tests\nnpm test -- src/path/to/test.ts\n\n# Generate test coverage report\nnpm run test:coverage\n```\n\n## Качество кода\n\n```bash\n# Lint code\nnpm run lint\n\n# Format code with Prettier\nnpm run format\n\n# Check types\nnpm run typecheck\n```\n\n***\n\n# Создание пользовательских инструментов\n\nЧтобы добавить собственные инструменты на сервер, выполните следующие действия:\n\n## 1. Определите уровень обслуживания\n\nСоздайте новую службу в `src/services/` для взаимодействия с вашим внешним API:\n\n```typescript\n// src/services/example.service.ts\nimport { Logger } from '../utils/logger.util.js';\n\nconst logger = Logger.forContext('services/example.service.ts');\n\nexport async function getData(param: string): Promise {\n\tlogger.debug('Getting data', { param });\n\t// API interaction code here\n\treturn { result: 'example data' };\n}\n```\n\n## 2. Создать контроллер\n\nДобавьте контроллер в `src/controllers/` для обработки бизнес-логики:\n\n```typescript\n// src/controllers/example.controller.ts\nimport { Logger } from '../utils/logger.util.js';\nimport * as exampleService from '../services/example.service.js';\nimport { formatMarkdown } from '../utils/formatter.util.js';\nimport { handleControllerError } from '../utils/error-handler.util.js';\nimport { ControllerResponse } from '../types/common.types.js';\n\nconst logger = Logger.forContext('controllers/example.controller.ts');\n\nexport interface GetDataOptions {\n\tparam?: string;\n}\n\nexport async function getData(\n\toptions: GetDataOptions = {},\n): Promise {\n\ttry {\n\t\tlogger.debug('Getting data with options', options);\n\n\t\tconst data = await exampleService.getData(options.param || 'default');\n\n\t\tconst content = formatMarkdown(data);\n\n\t\treturn { content };\n\t} catch (error) {\n\t\tthrow handleControllerError(error, {\n\t\t\tentityType: 'ExampleData',\n\t\t\toperation: 'getData',\n\t\t\tsource: 'controllers/example.controller.ts',\n\t\t});\n\t}\n}\n```\n\n## 3. Внедрение инструмента MCP\n\nСоздайте определение инструмента в `src/tools/` :\n\n```typescript\n// src/tools/example.tool.ts\nimport { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport { z } from 'zod';\nimport { Logger } from '../utils/logger.util.js';\nimport { formatErrorForMcpTool } from '../utils/error.util.js';\nimport * as exampleController from '../controllers/example.controller.js';\n\nconst logger = Logger.forContext('tools/example.tool.ts');\n\nconst GetDataArgs = z.object({\n\tparam: z.string().optional().describe('Optional parameter'),\n});\n\ntype GetDataArgsType = z.infer;\n\nasync function handleGetData(args: GetDataArgsType) {\n\ttry {\n\t\tlogger.debug('Tool get_data called', args);\n\n\t\tconst result = await exampleController.getData({\n\t\t\tparam: args.param,\n\t\t});\n\n\t\treturn {\n\t\t\tcontent: [{ type: 'text' as const, text: result.content }],\n\t\t};\n\t} catch (error) {\n\t\tlogger.error('Tool get_data failed', error);\n\t\treturn formatErrorForMcpTool(error);\n\t}\n}\n\nexport function register(server: McpServer) {\n\tserver.tool(\n\t\t'get_data',\n\t\t`Gets data from the example API, optionally using \\`param\\`.\nUse this to fetch example data. Returns formatted data as Markdown.`,\n\t\tGetDataArgs.shape,\n\t\thandleGetData,\n\t);\n}\n```\n\n## 4. Добавить поддержку CLI\n\nСоздайте команду CLI в `src/cli/` :\n\n```typescript\n// src/cli/example.cli.ts\nimport { program } from 'commander';\nimport { Logger } from '../utils/logger.util.js';\nimport * as exampleController from '../controllers/example.controller.js';\nimport { handleCliError } from '../utils/error-handler.util.js';\n\nconst logger = Logger.forContext('cli/example.cli.ts');\n\nprogram\n\t.command('get-data')\n\t.description('Get example data')\n\t.option('--param ', 'Optional parameter')\n\t.action(async (options) => {\n\t\ttry {\n\t\t\tlogger.debug('CLI get-data called', options);\n\n\t\t\tconst result = await exampleController.getData({\n\t\t\t\tparam: options.param,\n\t\t\t});\n\n\t\t\tconsole.log(result.content);\n\t\t} catch (error) {\n\t\t\thandleCliError(error);\n\t\t}\n\t});\n```\n\n## 5. Регистрация компонентов\n\nОбновите точки входа для регистрации новых компонентов:\n\n```typescript\n// In src/cli/index.ts\nimport '../cli/example.cli.js';\n\n// In src/index.ts (for the tool)\nimport exampleTool from './tools/example.tool.js';\n// Then in registerTools function:\nexampleTool.register(server);\n```\n\n***\n\n# Инструменты отладки\n\n## Инспектор МКП\n\nПолучите доступ к визуальному инспектору MCP, чтобы протестировать свои инструменты и просмотреть сведения о запросах/ответах:\n\n1. Запустите `npm run dev:server`\n2. Откройте в вашем браузере.\n3. Тестируйте свои инструменты и просматривайте журналы прямо в пользовательском интерфейсе\n\n## Журналы сервера\n\nВключить журналы отладки для разработки:\n\n```bash\n# Set environment variable\nDEBUG=true npm run dev:server\n\n# Or configure in ~/.mcp/configs.json\n```\n\n***\n\n# Публикация вашего MCP-сервера\n\nКогда вы будете готовы опубликовать свой собственный сервер MCP:\n\n1. Обновите package.json, указав свои данные.\n2. Обновите README.md документацией по вашему инструменту.\n3. Соберите проект: `npm run build`\n4. Протестируйте производственную сборку: `npm run start:server`\n5. Опубликовать в npm: `npm publish`\n\n***\n\n# Лицензия\n\n[Лицензия Массачусетского технологического института](https://opensource.org/licenses/MIT)\n\n```json\n{\n\t\"reviewwebsite\": {\n\t\t\"environments\": {\n\t\t\t\"DEBUG\": \"true\",\n\t\t\t\"REVIEWWEBSITE_API_KEY\": \"your-api-key-here\"\n\t\t}\n\t}\n}\n```\n\n**Примечание:** Для обратной совместимости сервер также распознает конфигурации под полным именем пакета ( `reviewwebsite-mcp-server` ) или именем пакета без области действия ( `reviewwebsite-mcp-server` ), если ключ `reviewwebsite` не найден. Однако для новых конфигураций рекомендуется использовать короткий ключ `reviewwebsite` .","Russian","ru-RU",{"_29":77,"_37":81,"_39":82},{"_31":78,"_33":79,"_35":80},"MCP 服务器将 AI 助手连接到 ReviewWebsite.com API，用于创建和管理网站评论、提取数据、将 URL 转换为 markdown 以及与 Web 内容进行交互。","审查网站 MCP 服务器","# ReviewWebsite.com - MCP 服务器\n\n该项目提供了一个模型上下文协议 (MCP) 服务器，将 AI 助手连接到[ReviewWebsite.com](https://reviewweb.site) API，以创建和管理网站评论、提取数据、将 URL 转换为 markdown 等。\n\n* [Github](https://github.com/mrgoonie/reviewwebsite-mcp-server)\n* [新公共管理](https://www.npmjs.com/package/reviewwebsite-mcp-server)\n\n### 可用功能\n\n* \\[x] 创建、阅读、更新和删除网站评论\n* \\[x] 获取可用的AI模型\n* \\[x] 使用 AI 将 URL 转换为 Markdown\n* \\[x] 使用 AI 从 URL 中提取结构化数据\n* \\[x] 抓取 URL 并提取内容\n* \\[x] 从网站提取链接\n* \\[x] 使用 AI 总结 URL 和网站\n* \\[x] SEO 洞察（关键词创意、关键词难度、流量分析、反向链接）\n* \\[x] 自定义AI模型和参数\n* \\[x] 控制等待行为和时间\n\n## 评论网站\n\n* [网站](https://reviewweb.site)\n* [API 文档](https://reviewweb.site/api-docs/)\n* [API Swagger 配置](https://reviewweb.site/api-docs/swagger-ui-init.js)\n* [在此](https://reviewweb.site/profile)创建您的 API 密钥\n\n## 支持的传输\n\n* \\[x] [“stdio”](https://modelcontextprotocol.io/specification/2025-03-26/basic/transports#stdio)传输 - CLI 使用的默认传输\n* \\[x][“可流式传输 HTTP”](https://modelcontextprotocol.io/specification/2025-03-26/basic/transports#streamable-http)传输 - 适用于基于 Web 的客户端\n * \\[ ] 实现身份验证（“授权”标头带有`Bearer ` ）\n* \\[ ] ~~“sse”运输~~**[（已弃用）](https://modelcontextprotocol.io/specification/2025-03-26/basic/transports#backwards-compatibility)**\n* \\[ ] 编写测试\n\n## 如何使用\n\n### 命令行界面\n\n```bash\n# Get available AI models\nnpm run dev:cli -- get-ai-models --api-key \"your-api-key\"\n\n# Create a new review\nnpm run dev:cli -- create-review --url \"https://example.com\" --instructions \"Review this website\" --api-key \"your-api-key\"\n\n# Get a specific review by ID\nnpm run dev:cli -- get-review --review-id \"review-id\" --api-key \"your-api-key\"\n\n# List all reviews\nnpm run dev:cli -- list-reviews --page 1 --limit 10 --api-key \"your-api-key\"\n\n# Update a review\nnpm run dev:cli -- update-review --review-id \"review-id\" --url \"https://example.com\" --instructions \"Updated instructions\" --api-key \"your-api-key\"\n\n# Delete a review\nnpm run dev:cli -- delete-review --review-id \"review-id\" --api-key \"your-api-key\"\n\n# Convert URL to Markdown\nnpm run dev:cli -- convert-to-markdown --url \"https://example.com\" --model \"gpt-4o\" --api-key \"your-api-key\"\n\n# Extract structured data from URL\nnpm run dev:cli -- extract-data --url \"https://example.com\" --instructions \"Extract product information\" --api-key \"your-api-key\"\n\n# Scrape URL\nnpm run dev:cli -- scrape-url --url \"https://example.com\" --api-key \"your-api-key\"\n\n# Extract links from URL\nnpm run dev:cli -- extract-links --url \"https://example.com\" --type \"all\" --api-key \"your-api-key\"\n\n# Summarize URL\nnpm run dev:cli -- summarize-url --url \"https://example.com\" --model \"gpt-4o\" --api-key \"your-api-key\"\n\n# Get keyword ideas for SEO\nnpm run dev:cli -- seo-keyword-ideas --keyword \"digital marketing\" --country \"us\" --search-engine \"Google\" --api-key \"your-api-key\"\n\n# Check keyword difficulty\nnpm run dev:cli -- seo-keyword-difficulty --keyword \"digital marketing\" --country \"us\" --api-key \"your-api-key\"\n\n# Analyze website traffic\nnpm run dev:cli -- seo-traffic --domain-or-url \"example.com\" --mode \"subdomains\" --country \"us\" --api-key \"your-api-key\"\n\n# Get backlinks for a domain\nnpm run dev:cli -- seo-backlinks --domain \"example.com\" --api-key \"your-api-key\"\n```\n\n### MCP 设置\n\n**对于使用 stdio 传输的本地配置：**\n\n```json\n{\n \"mcpServers\": {\n \"reviewwebsite\": {\n \"command\": \"node\",\n \"args\": [\"/path/to/reviewwebsite-mcp-server/dist/index.js\"],\n \"transportType\": \"stdio\"\n }\n }\n}\n```\n\n**对于远程 HTTP 配置：**\n\n```json\n{\n \"mcpServers\": {\n \"reviewwebsite\": {\n \"type\": \"http\",\n \"url\": \"http://localhost:8080/mcp\"\n }\n }\n}\n```\n\n**HTTP 传输的环境变量：**\n\n您可以使用以下环境变量配置 HTTP 服务器：\n\n* `MCP_HTTP_HOST` ：绑定到的主机（默认值： `127.0.0.1` ）\n* `MCP_HTTP_PORT` ：监听的端口（默认值： `8080` ）\n* `MCP_HTTP_PATH` ：端点路径（默认值： `/mcp` ）\n\n***\n\n# 源代码概述\n\n## 什么是 MCP？\n\n模型上下文协议 (MCP) 是一种开放标准，允许 AI 系统安全且上下文地与外部工具和数据源连接。\n\n该样板通过清晰的分层架构实现了 MCP 规范，可以扩展以构建任何 API 或数据源的自定义 MCP 服务器。\n\n## 为什么要使用这个样板？\n\n* **生产就绪架构**：遵循已发布的 MCP 服务器中使用的相同模式，CLI、工具、控制器和服务之间有明确的分离。\n\n* **类型安全**：使用 TypeScript 构建，以改善开发人员体验、代码质量和可维护性。\n\n* **工作示例**：包括一个完全实现的 IP 查找工具，演示从 CLI 到 API 集成的完整模式。\n\n* **测试框架**：配备单元和 CLI 集成测试的测试基础设施，包括覆盖率报告。\n\n* **开发工具**：包括 ESLint、Prettier、TypeScript 和其他为 MCP 服务器开发预先配置的质量工具。\n\n***\n\n# 入门\n\n## 先决条件\n\n* **Node.js** （>=18.x）：[下载](https://nodejs.org/)\n* **Git** ：用于版本控制\n\n***\n\n## 步骤 1：克隆并安装\n\n```bash\n# Clone the repository\ngit clone https://github.com/mrgoonie/reviewwebsite-mcp-server.git\ncd reviewwebsite-mcp-server\n\n# Install dependencies\nnpm install\n```\n\n***\n\n## 第 2 步：运行开发服务器\n\n使用 stdio 传输（默认）以开发模式启动服务器：\n\n```bash\nnpm run dev:server\n```\n\n或者使用 Streamable HTTP 传输：\n\n```bash\nnpm run dev:server:http\n```\n\n这将以热重载方式启动 MCP 服务器，并在启用 MCP 检查器。\n\n⚙️ 代理服务器正在监听 6277 端口 🔍 MCP Inspector 已启动并运行于\n\n当使用 HTTP 传输时，服务器默认在上可用。\n\n***\n\n## 步骤 3：测试 ReviewWebsite API 工具\n\n通过 CLI 使用 ReviewWebsite API 工具：\n\n```bash\n# Get available AI models\nnpm run dev:cli -- get-ai-models --api-key \"your-api-key\"\n\n# Create a review\nnpm run dev:cli -- create-review --url \"https://example.com\" --instructions \"Review this website\" --api-key \"your-api-key\"\n\n# Convert URL to Markdown\nnpm run dev:cli -- convert-to-markdown --url \"https://example.com\" --model \"gpt-4o\" --api-key \"your-api-key\"\n```\n\n***\n\n# 建筑学\n\n该样板遵循清晰的分层架构模式，可分离关注点并提高可维护性。\n\n## 项目结构\n\n```\nsrc/\n├── cli/ # Command-line interfaces\n├── controllers/ # Business logic\n├── resources/ # MCP resources: expose data and content from your servers to LLMs\n├── services/ # External API interactions\n├── tools/ # MCP tool definitions\n├── types/ # Type definitions\n├── utils/ # Shared utilities\n└── index.ts # Entry point\n```\n\n## 层次和职责\n\n### CLI 层（ `src/cli/*.cli.ts` ）\n\n* **目的**：定义解析参数和调用控制器的命令行接口\n* **命名**：文件应命名为`.cli.ts`\n* **测试**： `.cli.test.ts`中的 CLI 集成测试\n\n### 工具层（ `src/tools/*.tool.ts` ）\n\n* **目的**：为人工智能助手定义带有模式和描述的 MCP 工具\n* **命名**：文件应命名为`.tool.ts` ，类型为`.types.ts`\n* **模式**：每个工具都应该使用 zod 进行参数验证\n\n### 控制器层（ `src/controllers/*.controller.ts` ）\n\n* **目的**：实现业务逻辑、处理错误和格式化响应\n* **命名**：文件应命名为`.controller.ts`\n* **模式**：应返回标准化的`ControllerResponse`对象\n\n### 服务层（ `src/services/*.service.ts` ）\n\n* **目的**：与外部 API 或数据源交互\n* **命名**：文件应命名为`.service.ts`\n* **模式**：纯 API 交互，逻辑最少\n\n### 实用程序层 ( `src/utils/*.util.ts` )\n\n* **目的**：提供跨应用程序的共享功能\n* **主要用途**：\n * `logger.util.ts` ：结构化日志记录\n * `error.util.ts` ：错误处理和标准化\n * `formatter.util.ts` ：Markdown 格式化助手\n\n***\n\n# 开发指南\n\n## 开发脚本\n\n```bash\n# Start server in development mode (hot-reload & inspector)\nnpm run dev:server\n\n# Run CLI in development mode\nnpm run dev:cli -- [command] [args]\n\n# Build the project\nnpm run build\n\n# Start server in production mode\nnpm run start:server\n\n# Run CLI in production mode\nnpm run start:cli -- [command] [args]\n```\n\n## 测试\n\n```bash\n# Run all tests\nnpm test\n\n# Run specific tests\nnpm test -- src/path/to/test.ts\n\n# Generate test coverage report\nnpm run test:coverage\n```\n\n## 代码质量\n\n```bash\n# Lint code\nnpm run lint\n\n# Format code with Prettier\nnpm run format\n\n# Check types\nnpm run typecheck\n```\n\n***\n\n# 构建自定义工具\n\n按照以下步骤将您自己的工具添加到服务器：\n\n## 1.定义服务层\n\n在`src/services/`中创建一个新服务来与您的外部 API 交互：\n\n```typescript\n// src/services/example.service.ts\nimport { Logger } from '../utils/logger.util.js';\n\nconst logger = Logger.forContext('services/example.service.ts');\n\nexport async function getData(param: string): Promise {\n\tlogger.debug('Getting data', { param });\n\t// API interaction code here\n\treturn { result: 'example data' };\n}\n```\n\n## 2.创建控制器\n\n在`src/controllers/`中添加一个控制器来处理业务逻辑：\n\n```typescript\n// src/controllers/example.controller.ts\nimport { Logger } from '../utils/logger.util.js';\nimport * as exampleService from '../services/example.service.js';\nimport { formatMarkdown } from '../utils/formatter.util.js';\nimport { handleControllerError } from '../utils/error-handler.util.js';\nimport { ControllerResponse } from '../types/common.types.js';\n\nconst logger = Logger.forContext('controllers/example.controller.ts');\n\nexport interface GetDataOptions {\n\tparam?: string;\n}\n\nexport async function getData(\n\toptions: GetDataOptions = {},\n): Promise {\n\ttry {\n\t\tlogger.debug('Getting data with options', options);\n\n\t\tconst data = await exampleService.getData(options.param || 'default');\n\n\t\tconst content = formatMarkdown(data);\n\n\t\treturn { content };\n\t} catch (error) {\n\t\tthrow handleControllerError(error, {\n\t\t\tentityType: 'ExampleData',\n\t\t\toperation: 'getData',\n\t\t\tsource: 'controllers/example.controller.ts',\n\t\t});\n\t}\n}\n```\n\n## 3. 实现MCP工具\n\n在`src/tools/`中创建工具定义：\n\n```typescript\n// src/tools/example.tool.ts\nimport { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport { z } from 'zod';\nimport { Logger } from '../utils/logger.util.js';\nimport { formatErrorForMcpTool } from '../utils/error.util.js';\nimport * as exampleController from '../controllers/example.controller.js';\n\nconst logger = Logger.forContext('tools/example.tool.ts');\n\nconst GetDataArgs = z.object({\n\tparam: z.string().optional().describe('Optional parameter'),\n});\n\ntype GetDataArgsType = z.infer;\n\nasync function handleGetData(args: GetDataArgsType) {\n\ttry {\n\t\tlogger.debug('Tool get_data called', args);\n\n\t\tconst result = await exampleController.getData({\n\t\t\tparam: args.param,\n\t\t});\n\n\t\treturn {\n\t\t\tcontent: [{ type: 'text' as const, text: result.content }],\n\t\t};\n\t} catch (error) {\n\t\tlogger.error('Tool get_data failed', error);\n\t\treturn formatErrorForMcpTool(error);\n\t}\n}\n\nexport function register(server: McpServer) {\n\tserver.tool(\n\t\t'get_data',\n\t\t`Gets data from the example API, optionally using \\`param\\`.\nUse this to fetch example data. Returns formatted data as Markdown.`,\n\t\tGetDataArgs.shape,\n\t\thandleGetData,\n\t);\n}\n```\n\n## 4.添加CLI支持\n\n在`src/cli/`中创建一个 CLI 命令：\n\n```typescript\n// src/cli/example.cli.ts\nimport { program } from 'commander';\nimport { Logger } from '../utils/logger.util.js';\nimport * as exampleController from '../controllers/example.controller.js';\nimport { handleCliError } from '../utils/error-handler.util.js';\n\nconst logger = Logger.forContext('cli/example.cli.ts');\n\nprogram\n\t.command('get-data')\n\t.description('Get example data')\n\t.option('--param ', 'Optional parameter')\n\t.action(async (options) => {\n\t\ttry {\n\t\t\tlogger.debug('CLI get-data called', options);\n\n\t\t\tconst result = await exampleController.getData({\n\t\t\t\tparam: options.param,\n\t\t\t});\n\n\t\t\tconsole.log(result.content);\n\t\t} catch (error) {\n\t\t\thandleCliError(error);\n\t\t}\n\t});\n```\n\n## 5. 注册组件\n\n更新入口点以注册新组件：\n\n```typescript\n// In src/cli/index.ts\nimport '../cli/example.cli.js';\n\n// In src/index.ts (for the tool)\nimport exampleTool from './tools/example.tool.js';\n// Then in registerTools function:\nexampleTool.register(server);\n```\n\n***\n\n# 调试工具\n\n## MCP 检查器\n\n访问可视化 MCP 检查器来测试您的工具并查看请求/响应详细信息：\n\n1. 运行`npm run dev:server`\n2. 在浏览器中打开\n3. 测试您的工具并直接在 UI 中查看日志\n\n## 服务器日志\n\n启用开发调试日志：\n\n```bash\n# Set environment variable\nDEBUG=true npm run dev:server\n\n# Or configure in ~/.mcp/configs.json\n```\n\n***\n\n# 发布您的 MCP 服务器\n\n准备发布您的自定义 MCP 服务器时：\n\n1. 使用您的详细信息更新 package.json\n2. 使用您的工具文档更新 README.md\n3. 构建项目： `npm run build`\n4. 测试生产版本： `npm run start:server`\n5. 发布到 npm： `npm publish`\n\n***\n\n# 执照\n\n[MIT 许可证](https://opensource.org/licenses/MIT)\n\n```json\n{\n\t\"reviewwebsite\": {\n\t\t\"environments\": {\n\t\t\t\"DEBUG\": \"true\",\n\t\t\t\"REVIEWWEBSITE_API_KEY\": \"your-api-key-here\"\n\t\t}\n\t}\n}\n```\n\n\\*\\*注意：\\*\\*为了向后兼容，如果未找到`reviewwebsite`键，服务器也会识别完整软件包名称 ( `reviewwebsite-mcp-server` ) 或未指定范围的软件包名称 ( `reviewwebsite-mcp-server` ) 下的配置。但是，建议对新配置使用短`reviewwebsite`键。","Chinese","zh-CN","githubUser","locale",{"_86":87,"_13":88,"_98":43,"_99":43,"_33":44,"_16":100,"_101":102,"_148":149,"_156":-5,"_157":158,"_159":160,"_161":162,"_223":224,"_229":-5,"_109":206,"_230":231,"_112":232,"_233":234},"addedAt","2025-05-08T05:01:05.182389Z",[89,90,91,92,93,94,95,96,97],"category:web-scraping","category:browser-automation","category:text-summarization","environment:network","hosting:remote-capable","language:typescript","security_grade:a","quality_grade:a","author:claimed","descriptionMarkdown","descriptionPlainText",6443,"integrations",[103,114,121,127,134,141],{"_104":105,"_31":111,"_112":113},"brand",{"_106":107,"_37":108,"_109":110},"logoSvgPath","M12 .297c-6.63 0-12 5.373-12 12 0 5.303 3.438 9.8 8.205 11.385.6.113.82-.258.82-.577 0-.285-.01-1.04-.015-2.04-3.338.724-4.042-1.61-4.042-1.61C4.422 18.07 3.633 17.7 3.633 17.7c-1.087-.744.084-.729.084-.729 1.205.084 1.838 1.236 1.838 1.236 1.07 1.835 2.809 1.305 3.495.998.108-.776.417-1.305.76-1.605-2.665-.3-5.466-1.332-5.466-5.93 0-1.31.465-2.38 1.235-3.22-.135-.303-.54-1.523.105-3.176 0 0 1.005-.322 3.3 1.23.96-.267 1.98-.399 3-.405 1.02.006 2.04.138 3 .405 2.28-1.552 3.285-1.23 3.285-1.23.645 1.653.24 2.873.12 3.176.765.84 1.23 1.91 1.23 3.22 0 4.61-2.805 5.625-5.475 5.92.42.36.81 1.096.81 2.22 0 1.606-.015 2.896-.015 3.286 0 .315.21.69.825.57C20.565 22.092 24 17.592 24 12.297c0-6.627-5.373-12-12-12","GitHub","slug","github","Connects to the ReviewWebsite.com API hosted on GitHub, enabling AI assistants to create, read, update, and delete website reviews, as well as extract and process website content.","uid","gifmmd5exl",{"_104":115,"_31":119,"_112":120},{"_106":116,"_37":117,"_109":118},"M22.27 19.385H1.73A1.73 1.73 0 010 17.655V6.345a1.73 1.73 0 011.73-1.73h20.54A1.73 1.73 0 0124 6.345v11.308a1.73 1.73 0 01-1.73 1.731zM5.769 15.923v-4.5l2.308 2.885 2.307-2.885v4.5h2.308V8.078h-2.308l-2.307 2.885-2.308-2.885H3.46v7.847zM21.232 12h-2.309V8.077h-2.307V12h-2.308l3.461 4.039z","Markdown","markdown","Converts URLs to Markdown format using AI models, allowing for structured representation of website content that can be used in reviews and other applications.","bxg1snj1oq",{"_104":122,"_31":125,"_112":126},{"_106":123,"_37":124,"_109":124},"M1.763 0C.786 0 0 .786 0 1.763v20.474C0 23.214.786 24 1.763 24h20.474c.977 0 1.763-.786 1.763-1.763V1.763C24 .786 23.214 0 22.237 0zM5.13 5.323l13.837.019-.009 13.836h-3.464l.01-10.382h-3.456L12.04 19.17H5.113z","npm","Provides access to the ReviewWebsite.com API, allowing AI assistants to create and manage website reviews, extract data from URLs, convert URLs to markdown, scrape content, extract links, and summarize websites.","3kh1zp7efz",{"_104":128,"_31":132,"_112":133},{"_106":129,"_37":130,"_109":131},"M12 0C5.383 0 0 5.383 0 12s5.383 12 12 12c6.616 0 12-5.383 12-12S18.616 0 12 0zm0 1.144c5.995 0 10.856 4.86 10.856 10.856 0 5.995-4.86 10.856-10.856 10.856-5.996 0-10.856-4.86-10.856-10.856C1.144 6.004 6.004 1.144 12 1.144zM8.37 5.868a6.707 6.707 0 0 0-.423.005c-.983.056-1.573.517-1.735 1.472-.115.665-.096 1.348-.143 2.017-.013.35-.05.697-.115 1.038-.134.609-.397.798-1.016.83a2.65 2.65 0 0 0-.244.042v1.463c1.126.055 1.278.452 1.37 1.629.033.429-.013.858.015 1.287.018.406.073.808.156 1.2.259 1.075 1.307 1.435 2.575 1.218v-1.283c-.203 0-.383.005-.558 0-.43-.013-.591-.12-.632-.535-.056-.535-.042-1.08-.075-1.62-.064-1.001-.175-1.988-1.153-2.625.503-.37.868-.812.983-1.398.083-.41.134-.821.166-1.237.028-.415-.023-.84.014-1.25.06-.665.102-.937.9-.91.12 0 .235-.017.369-.027v-1.31c-.16 0-.31-.004-.454-.006zm7.593.009a4.247 4.247 0 0 0-.813.06v1.274c.245 0 .434 0 .623.005.328.004.577.13.61.494.032.332.031.669.064 1.006.065.669.101 1.347.217 2.007.102.544.475.95.941 1.283-.817.549-1.057 1.333-1.098 2.215-.023.604-.037 1.213-.069 1.822-.028.554-.222.734-.78.748-.157.004-.31.018-.484.028v1.305c.327 0 .627.019.927 0 .932-.055 1.495-.507 1.68-1.412.078-.498.124-1 .138-1.504.032-.461.028-.927.074-1.384.069-.715.397-1.01 1.112-1.057a.972.972 0 0 0 .199-.046v-1.463c-.12-.014-.204-.027-.291-.032-.536-.023-.804-.203-.937-.71a5.146 5.146 0 0 1-.152-.993c-.037-.618-.033-1.241-.074-1.86-.08-1.192-.794-1.753-1.887-1.786zm-6.89 5.28a.844.844 0 0 0-.083 1.684h.055a.83.83 0 0 0 .877-.78v-.046a.845.845 0 0 0-.83-.858zm2.911 0a.808.808 0 0 0-.834.78c0 .027 0 .05.004.078 0 .503.342.826.859.826.507 0 .826-.332.826-.853-.005-.503-.342-.836-.855-.831zm2.963 0a.861.861 0 0 0-.876.835c0 .47.378.849.849.849h.009c.425.074.853-.337.881-.83.023-.457-.392-.854-.863-.854z","Swagger","swagger","Integrates with ReviewWebsite.com's API using Swagger configuration, providing a standardized way to access review management and website data extraction features.","k9smn6shvl",{"_104":135,"_31":139,"_112":140},{"_106":136,"_37":137,"_109":138},"M1.125 0C.502 0 0 .502 0 1.125v21.75C0 23.498.502 24 1.125 24h21.75c.623 0 1.125-.502 1.125-1.125V1.125C24 .502 23.498 0 22.875 0zm17.363 9.75c.612 0 1.154.037 1.627.111a6.38 6.38 0 0 1 1.306.34v2.458a3.95 3.95 0 0 0-.643-.361 5.093 5.093 0 0 0-.717-.26 5.453 5.453 0 0 0-1.426-.2c-.3 0-.573.028-.819.086a2.1 2.1 0 0 0-.623.242c-.17.104-.3.229-.393.374a.888.888 0 0 0-.14.49c0 .196.053.373.156.529.104.156.252.304.443.444s.423.276.696.41c.273.135.582.274.926.416.47.197.892.407 1.266.628.374.222.695.473.963.753.268.279.472.598.614.957.142.359.214.776.214 1.253 0 .657-.125 1.21-.373 1.656a3.033 3.033 0 0 1-1.012 1.085 4.38 4.38 0 0 1-1.487.596c-.566.12-1.163.18-1.79.18a9.916 9.916 0 0 1-1.84-.164 5.544 5.544 0 0 1-1.512-.493v-2.63a5.033 5.033 0 0 0 3.237 1.2c.333 0 .624-.03.872-.09.249-.06.456-.144.623-.25.166-.108.29-.234.373-.38a1.023 1.023 0 0 0-.074-1.089 2.12 2.12 0 0 0-.537-.5 5.597 5.597 0 0 0-.807-.444 27.72 27.72 0 0 0-1.007-.436c-.918-.383-1.602-.852-2.053-1.405-.45-.553-.676-1.222-.676-2.005 0-.614.123-1.141.369-1.582.246-.441.58-.804 1.004-1.089a4.494 4.494 0 0 1 1.47-.629 7.536 7.536 0 0 1 1.77-.201zm-15.113.188h9.563v2.166H9.506v9.646H6.789v-9.646H3.375z","TypeScript","typescript","Utilizes TypeScript for improved developer experience when interacting with the ReviewWebsite.com API, providing type safety for review management and website data extraction.","floocioqsy",{"_104":142,"_31":146,"_112":147},{"_106":143,"_37":144,"_109":145},"M19.088 2.477 24 7.606 12.521 20.485l-.925 1.038L0 7.559l5.108-5.082h13.98Zm-17.434 5.2 6.934-4.003H5.601L1.619 7.636l.035.041Zm12.117-4.003L3.333 9.7l2.149 2.588 10.809-6.241-.2-.346 2.851-1.646-.365-.381h-4.806Zm7.52 2.834L8.257 14.034h5.101v-.4h3.667l5.346-5.998-1.08-1.128Zm-7.129 10.338H9.268l2.36 2.843 2.534-2.843Z","Zod","zod","Leverages Zod for schema validation when interacting with the ReviewWebsite.com API, ensuring proper data formatting for website reviews and content extraction.","komee8i962","namespace",{"_150":151,"_109":155},"owner",{"_152":153},"githubAccount",{"_154":155},"login","mrgoonie","readmeMarkdown","recentUsage",0,"redditPostExternalId","1khiitm","repository",{"_163":164,"_192":193,"_196":197,"_215":-5,"_216":217,"_218":219,"_222":-5},"argumentsJsonSchema",{"_165":166,"_189":190,"_172":191},"properties",{"_167":168,"_174":175,"_178":179,"_182":183,"_186":187},"DEBUG",{"_169":170,"_31":171,"_172":173},"default","true","Enable debug logs for development","type","string","MCP_HTTP_HOST",{"_169":176,"_31":177,"_172":173},"127.0.0.1","The host to bind to for HTTP transport","MCP_HTTP_PATH",{"_169":180,"_31":181,"_172":173},"/mcp","The endpoint path for HTTP transport","MCP_HTTP_PORT",{"_169":184,"_31":185,"_172":173},"8080","The port to listen on for HTTP transport","REVIEWWEBSITE_API_KEY",{"_31":188,"_172":173},"Your ReviewWebsite.com API key","required",[186],"object","githubProject",{"_35":45,"_194":195},"url","https://github.com/mrgoonie/reviewwebsite-mcp-server","githubRepository",{"_198":199,"_200":201,"_202":203,"_16":204,"_205":137,"_37":206,"_150":207,"_209":158,"_210":211,"_213":214},"defaultBranch","main","fullName","mrgoonie/reviewwebsite-mcp-server","githubTreeId",354007,12706,"language","reviewwebsite-mcp-server",{"_154":155,"_112":208},"b1MoZc7jqF","recentStargazers","spdxLicense",{"_37":212},"MIT License","stargazers",4,"glamaJson","inspectable",true,"npmPackage",{"_37":206,"_220":221},"weeklyDownloads",11,"supportedPlatforms","scores",{"_225":-5,"_226":227,"_228":227},"license","quality",100,"security","simpleIcon","toolCount",15,"hww6ztx29c","updatedAt","2025-10-07T08:15:22.569995Z","meta",[237,240,242,249,252,254,257,260,263,266,269,271,274,277,279,281,283,285,287],{"_238":239},"title","ReviewWebsite MCP Server | Glama",{"_241":43,"_37":31},"content",{"_243":244,"_245":246,"_247":248},"href","https://glama.ai/mcp/servers/@mrgoonie/reviewwebsite-mcp-server","rel","canonical","tagName","link",{"_241":44,"_250":251},"property","og:title",{"_241":43,"_250":253},"og:description",{"_241":255,"_250":256},"https://glama.ai/logo.png","og:logo",{"_241":258,"_250":259},"https://glama.ai/mcp/servers/@mrgoonie/reviewwebsite-mcp-server/og-image","og:image",{"_241":261,"_250":262},"630","og:image:height",{"_241":264,"_250":265},"1200","og:image:width",{"_241":267,"_250":268},"website","og:type",{"_241":244,"_250":270},"og:url",{"_241":272,"_250":273},"Glama – MCP Hosting Platform","og:site_name",{"_241":275,"_37":276},"summary_large_image","twitter:card",{"_241":272,"_37":278},"twitter:title",{"_241":43,"_37":280},"twitter:description",{"_241":258,"_37":282},"twitter:image",{"_241":261,"_37":284},"twitter:image:height",{"_241":264,"_37":286},"twitter:image:width",{"_288":289},"script:ld+json",{"_290":291,"_292":293},"@context","http://schema.org","@graph",[294],{"_290":295,"_296":297,"_298":299},"https://schema.org","@type","BreadcrumbList","itemListElement",[300,307,310,314],{"_296":301,"_302":303,"_37":304,"_305":306},"ListItem","item","https://glama.ai/","Glama","position",1,{"_296":301,"_302":308,"_37":309,"_305":22},"https://glama.ai/mcp","MCP",{"_296":301,"_302":311,"_37":312,"_305":313},"https://glama.ai/mcp/servers","Servers",3,{"_296":301,"_302":244,"_37":44,"_305":214},"visitorIsMaintainer",false,"routes/_public/mcp/servers/~namespace/~slug/_pages/_explorer/blob/~commit/~/_route",{"_319":320,"_29":326,"_359":360,"_235":373,"_371":397,"_398":399},"blob",{"_241":321,"_322":323,"_324":325},"export * from './helper';\nexport * from './storage-upload';\nexport * from './types';\n","fileName","index.ts","size",85,{"_86":87,"_13":327,"_98":43,"_99":43,"_33":44,"_16":100,"_101":328,"_148":341,"_156":-5,"_157":158,"_159":160,"_161":344,"_223":358,"_229":-5,"_109":206,"_230":231,"_112":232,"_233":234},[89,90,91,92,93,94,95,96,97],[329,331,333,335,337,339],{"_104":330,"_31":111,"_112":113},{"_106":107,"_37":108,"_109":110},{"_104":332,"_31":119,"_112":120},{"_106":116,"_37":117,"_109":118},{"_104":334,"_31":125,"_112":126},{"_106":123,"_37":124,"_109":124},{"_104":336,"_31":132,"_112":133},{"_106":129,"_37":130,"_109":131},{"_104":338,"_31":139,"_112":140},{"_106":136,"_37":137,"_109":138},{"_104":340,"_31":146,"_112":147},{"_106":143,"_37":144,"_109":145},{"_150":342,"_109":155},{"_152":343},{"_154":155},{"_163":345,"_192":353,"_196":354,"_215":-5,"_216":217,"_218":357,"_222":-5},{"_165":346,"_189":352,"_172":191},{"_167":347,"_174":348,"_178":349,"_182":350,"_186":351},{"_169":170,"_31":171,"_172":173},{"_169":176,"_31":177,"_172":173},{"_169":180,"_31":181,"_172":173},{"_169":184,"_31":185,"_172":173},{"_31":188,"_172":173},[186],{"_35":45,"_194":195},{"_198":199,"_200":201,"_202":203,"_16":204,"_205":137,"_37":206,"_150":355,"_209":158,"_210":356,"_213":214},{"_154":155,"_112":208},{"_37":212},{"_37":206,"_220":221},{"_225":-5,"_226":227,"_228":227},"member",{"_361":362,"_365":366,"_367":368,"_202":369,"_370":316,"_371":323,"_372":217,"_324":325,"_172":319},"commit",{"_363":364},"sha","7aa1f4886ba73ba58c76a5fc47e299f73909cd31","contentStoredObjectPointerId",10429020,"fullPath","src/libs/cloud-storage/index.ts",353998,"indexable","path","safeToDisplayAsText",[374,376,378,380,382,383,384,386,387,388,389,390,391,392,393,394,395,396],{"_238":375},"index.ts | ReviewWebsite MCP Server | Glama",{"_241":377,"_37":31},"Enterprise-grade security, privacy, and features like agents, MCP, prompt templates, and more.",{"_243":379,"_245":246,"_247":248},"https://glama.ai/mcp/servers/@mrgoonie/reviewwebsite-mcp-server/blob/7aa1f4886ba73ba58c76a5fc47e299f73909cd31/src/libs/cloud-storage",{"_241":381,"_250":251},"index.ts | ReviewWebsite MCP Server",{"_241":377,"_250":253},{"_241":255,"_250":256},{"_241":385,"_250":259},"https://glama.ai/generated-images/og?title=index.ts+%7C+ReviewWebsite+MCP+Server",{"_241":261,"_250":262},{"_241":264,"_250":265},{"_241":267,"_250":268},{"_241":379,"_250":270},{"_241":272,"_250":273},{"_241":275,"_37":276},{"_241":272,"_37":278},{"_241":377,"_37":280},{"_241":385,"_37":282},{"_241":261,"_37":284},{"_241":264,"_37":286},"src/libs/cloud-storage","treeMembers",[400,404,406,410],{"_361":401,"_367":402,"_371":403,"_172":319},{"_363":364},"src/libs/cloud-storage/helper.ts","helper.ts",{"_361":405,"_367":368,"_371":323,"_172":319},{"_363":364},{"_361":407,"_367":408,"_371":409,"_172":319},{"_363":364},"src/libs/cloud-storage/storage-upload.ts","storage-upload.ts",{"_361":411,"_367":412,"_371":413,"_172":319},{"_363":364},"src/libs/cloud-storage/types.ts","types.ts","actionData","errors"]

MCP directory API