Merge pull request #577 from devoxx/feature-robust-mcp-check

Feature robust mcp check

Author: stephanj

docusaurus/.gitignore

@@ -0,0 +1,20 @@
+# Dependencies
+/node_modules
+
+# Production
+/build
+
+# Generated files
+.docusaurus
+.cache-loader
+
+# Misc
+.DS_Store
+.env.local
+.env.development.local
+.env.test.local
+.env.production.local
+
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*

docusaurus/README.md

@@ -0,0 +1,80 @@
+# DevoxxGenie Documentation
+
+This directory contains the documentation website for the DevoxxGenie IntelliJ IDEA plugin, built with [Docusaurus](https://docusaurus.io/).
+
+## Local Development
+
+### Prerequisites
+
+- [Node.js](https://nodejs.org/en/download/) version 18 or above
+- [npm](https://www.npmjs.com/) (comes with Node.js)
+
+### Installation
+
+```bash
+npm install
+```
+
+### About Image Placeholders
+
+The documentation references many screenshots that need to be created. For development and testing, we use automatically generated placeholder images.
+
+The `npm start` and `npm run build` commands will automatically generate these placeholders for all missing images. You don't need to run any separate commands for this.
+
+### Local Development Server
+
+```bash
+npm run start
+```
+
+This command starts a local development server and opens up a browser window. Most changes are reflected live without having to restart the server.
+
+### Build
+
+```bash
+npm run build
+```
+
+This command generates static content into the `build` directory and can be served using any static contents hosting service.
+
+## Adding Screenshots
+
+Replace the placeholder images in the `static/img` directory with actual screenshots of the plugin:
+
+1. Take screenshots of the relevant features in the plugin
+2. Save them with the same filenames as the placeholders
+3. Place them in the `static/img` directory
+
+## Structure
+
+- `docs/`: Documentation content in Markdown
+- `src/`: React components for custom pages
+- `static/`: Static assets like images
+- `docusaurus.config.js`: Docusaurus configuration
+- `sidebars.js`: Sidebar structure for documentation
+
+## Adding Content
+
+### Adding Documentation Pages
+
+1. Add Markdown files to the `docs` directory
+2. Update `sidebars.js` if you want to add the page to the sidebar
+
+### Adding Images
+
+1. Place image files in `static/img/`
+2. Reference them in Markdown using relative paths: `![Alt text](/img/example.png)`
+
+### Adding Components
+
+If you need custom React components, add them to the `src/components/` directory.
+
+## Deployment
+
+The documentation site can be deployed to GitHub Pages:
+
+```bash
+GIT_USER=<Your GitHub username> npm run deploy
+```
+
+This command is a convenient way to build the website and push to the `gh-pages` branch.

docusaurus/WEBSITE.md

@@ -0,0 +1,77 @@
+# DevoxxGenie Documentation Website
+
+This folder contains a [Docusaurus](https://docusaurus.io/) website that provides comprehensive documentation for the DevoxxGenie plugin.
+
+## Running the Documentation Site
+
+### Prerequisites
+
+- Node.js version 18 or higher
+- npm (comes with Node.js)
+
+### On Unix/Linux/macOS
+
+1. Make the install script executable:
+   ```bash
+   chmod +x install.sh
+   ```
+
+2. Run the install script:
+   ```bash
+   ./install.sh
+   ```
+
+### On Windows
+
+1. Run the install script:
+   ```cmd
+   install.bat
+   ```
+
+Alternatively, you can manually install and run the site:
+
+```bash
+# Install dependencies
+npm install
+
+# Start development server
+npm start
+```
+
+## Building for Production
+
+To build the website for production deployment:
+
+```bash
+npm run build
+```
+
+This will generate static content in the `build` directory that can be served by any static hosting service.
+
+## Deploying to GitHub Pages
+
+The documentation can be deployed to GitHub Pages with:
+
+```bash
+GIT_USER=<Your GitHub username> npm run deploy
+```
+
+## Documentation Structure
+
+- `docs/`: Contains all documentation markdown files
+- `blog/`: Contains blog posts
+- `static/`: Contains static assets like images
+- `src/`: Contains React components and custom pages
+
+## Contributing to Documentation
+
+1. Add or modify content in the appropriate folders
+2. Run the development server to preview changes
+3. Submit a pull request with your changes
+
+## Best Practices
+
+- Keep documentation up to date with the latest plugin features
+- Include screenshots and diagrams where helpful
+- Provide clear step-by-step instructions
+- Follow the existing organization and style

docusaurus/blog/2025-03-24-devoxxgenie-assistant-for-idea.md

@@ -0,0 +1,78 @@
+---
+slug: devoxxgenie-assistant-for-idea
+title: DevoxxGenie - Your AI Assistant for IDEA
+authors: [devoxx]
+tags: [announcements, AI, IntelliJ IDEA]
+date: 2025-03-24
+---
+
+# DevoxxGenie: Your AI Assistant for IDEA
+
+DevoxxGenie is a powerful AI-powered assistant for IntelliJ IDEA that helps developers be more productive by leveraging the capabilities of Large Language Models (LLMs). Unlike other code assistants, DevoxxGenie is built entirely in Java and offers unique flexibility by supporting both local and cloud-based LLM providers.
+
+## A New Approach to AI Code Assistance
+
+Most AI coding assistants lock you into a specific model or cloud provider. DevoxxGenie takes a different approach, giving you the freedom to choose how you want to use AI in your development workflow:
+
+- Run models locally for privacy and offline use
+- Connect to cloud providers for more powerful capabilities
+- Switch between providers as needed without changing tools
+
+## Key Features
+
+DevoxxGenie offers a comprehensive set of features that integrate seamlessly with your development workflow:
+
+### Multi-Provider LLM Support
+
+Connect to a wide range of LLM providers:
+- **Local Providers**: Ollama, LMStudio, GPT4All, Llama.cpp, and more
+- **Cloud Providers**: OpenAI, Anthropic (Claude), Mistral, Groq, Google (Gemini), and others
+
+### Advanced Context Features
+
+- **MCP Support**: Access external tools and services for enhanced capabilities
+- **Project Scanner**: Add source code to prompt context for better responses
+- **Chat Memory**: Maintain conversation context for more coherent assistance
+
+### Developer-Focused Tools
+
+- **Git Diff/Merge**: Review and accept AI-generated code changes with a Git diff interface
+- **Web Search**: Augment LLM knowledge with web search results
+- **Token Cost Calculator**: Manage API usage efficiently
+- **MCP Support**: Model Context Protocol for extended capabilities
+
+## Getting Started
+
+Setting up DevoxxGenie is easy. Install the plugin from the JetBrains Marketplace, connect it to your preferred LLM provider, and start prompting. The plugin supports various workflows:
+
+1. **Code Explanation**: Select code and ask for explanations
+2. **Generation**: Request code generation for specific functionality
+3. **Refactoring**: Get suggestions for code improvements
+4. **Learning**: Ask questions about frameworks, libraries, or concepts
+
+## Why DevoxxGenie?
+
+1. **Built in Java**: Created by Java developers for the Java ecosystem
+2. **Provider Flexibility**: Use any supported LLM provider
+3. **Privacy Options**: Run models locally to keep your code private
+4. **Deep Integration**: Works seamlessly with IntelliJ IDEA
+5. **Open Source**: Community-driven development
+
+## The Future of DevoxxGenie
+
+The DevoxxGenie team is actively working on enhancing the plugin with new features:
+
+- **Enhanced MCP Support**: More specialized tools for development tasks
+- **Agentic AI**: More sophisticated reasoning and planning capabilities
+- **Enhanced MCP Support**: More specialized tools for development tasks
+- **Improved Multimodal Support**: Better handling of visual elements
+
+## Join the Community
+
+DevoxxGenie is an open-source project, and we welcome contributions from the community. Whether you're fixing bugs, improving documentation, or adding new features, your help is appreciated!
+
+Check out our [GitHub repository](https://github.com/devoxx/DevoxxGenieIDEAPlugin) to get involved.
+
+---
+
+Ready to try DevoxxGenie? Install it from the [JetBrains Marketplace](https://plugins.jetbrains.com/plugin/24169-devoxxgenie) and experience the next generation of AI-assisted development!

docusaurus/blog/authors.yml

@@ -0,0 +1,11 @@
+devoxx:
+  name: Devoxx Team
+  title: DevoxxGenie Development Team
+  url: https://github.com/devoxx
+  image_url: https://github.com/devoxx.png
+
+stephanj:
+  name: Stephan Janssen
+  title: Creator of DevoxxGenie
+  url: https://github.com/stephanj
+  image_url: https://github.com/stephanj.png

docusaurus/create-placeholder-images.sh

@@ -0,0 +1,54 @@
+#!/bin/bash
+# This script creates placeholder images for the Docusaurus site
+
+PLACEHOLDER_SVG="./static/img/devoxxgenie-placeholder.svg"
+IMG_DIR="./static/img"
+
+# List of all image names mentioned in the documentation
+image_names=(
+  "logo.svg"
+  "installation-marketplace.png"
+  "ollama-setup.png"
+  "openai-setup.png"
+  "provider-selection.png"
+  "custom-openai-settings.png"
+  "settings-llm-providers.png"
+  "prompts-settings.png"
+  "token-cost-settings.png"
+  "token-calculator.png"
+  "devoxxgenie-md-settings.png"
+  "chat-interface.png"
+  "rag-setup.png"
+  "rag-references.png"
+  "mcp-settings.png"
+  "mcp-logs.png"
+  "dnd-images.png"
+  "git-diff-settings.png"
+  "git-diff-viewer.png"
+  "add-project.png"
+  "project-scanner-settings.png"
+  "web-search-settings.png"
+  "chat-memory-settings.png"
+  "devoxxgenie-toolwindow.png"
+  "devoxxgenie-demo.gif"
+  "rag-feature.png"
+  "devoxxgenie-social-card.jpg"
+  "favicon.ico"
+)
+
+# Create placeholder image for each image name if it doesn't exist
+for img in "${image_names[@]}"; do
+  if [[ ! -f "$IMG_DIR/$img" ]]; then
+    echo "Creating placeholder for $img"
+    if [[ "$img" == *.svg ]]; then
+      cp "$PLACEHOLDER_SVG" "$IMG_DIR/$img"
+    else
+      # For non-SVG files, convert the SVG to the appropriate format
+      # This requires ImageMagick to be installed
+      # If ImageMagick is not available, simply copy the SVG as a placeholder
+      cp "$PLACEHOLDER_SVG" "$IMG_DIR/$img"
+    fi
+  fi
+done
+
+echo "Placeholder images created in $IMG_DIR"

docusaurus/create-placeholders.js

@@ -0,0 +1,67 @@
+// Create placeholder images for the documentation
+const fs = require('fs');
+const path = require('path');
+
+const imgDir = path.join(__dirname, 'static', 'img');
+
+// Create a basic SVG placeholder
+const createPlaceholderSvg = (filename) => {
+  const name = path.basename(filename, path.extname(filename));
+  const extension = path.extname(filename).slice(1);
+  
+  const svgContent = `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 400 200">
+    <rect width="400" height="200" fill="#e0e0e0"/>
+    <text x="200" y="100" font-family="Arial" font-size="18" text-anchor="middle" dominant-baseline="middle" fill="#333">${name}</text>
+    <text x="200" y="130" font-family="Arial" font-size="14" text-anchor="middle" dominant-baseline="middle" fill="#666">(${extension} placeholder)</text>
+  </svg>`;
+  
+  fs.writeFileSync(filename, svgContent);
+  console.log(`Created placeholder: ${filename}`);
+}
+
+// List of all image names mentioned in the documentation
+const imageNames = [
+  'logo.svg',
+  'installation-marketplace.png',
+  'ollama-setup.png',
+  'openai-setup.png',
+  'provider-selection.png',
+  'custom-openai-settings.png',
+  'settings-llm-providers.png',
+  'prompts-settings.png',
+  'token-cost-settings.png',
+  'token-calculator.png',
+  'devoxxgenie-md-settings.png',
+  'chat-interface.png',
+  'rag-setup.png',
+  'rag-references.png',
+  'mcp-settings.png',
+  'mcp-logs.png',
+  'dnd-images.png',
+  'git-diff-settings.png',
+  'git-diff-viewer.png',
+  'add-project.png',
+  'project-scanner-settings.png',
+  'web-search-settings.png',
+  'chat-memory-settings.png',
+  'devoxxgenie-toolwindow.png',
+  'devoxxgenie-demo.gif',
+  'rag-feature.png',
+  'devoxxgenie-social-card.jpg',
+];
+
+// Ensure img directory exists
+if (!fs.existsSync(imgDir)) {
+  fs.mkdirSync(imgDir, { recursive: true });
+  console.log(`Created directory: ${imgDir}`);
+}
+
+// Create placeholder image for each image name if it doesn't exist
+for (const img of imageNames) {
+  const imgPath = path.join(imgDir, img);
+  if (!fs.existsSync(imgPath)) {
+    createPlaceholderSvg(imgPath);
+  }
+}
+
+console.log('All placeholder images created in', imgDir);