Wikimedia MCP Server

# MCP Neurolora ![MCP Server](https://img.shields.io/badge/MCP-Server-blue) ![Version](https://img.shields.io/badge/version-1.4.0-green) ![License](https://img.shields.io/badge/license-MIT-blue) An intelligent MCP server that provides tools for code analysis using OpenAI API, code collection, and documentation generation. ## 🚀 Installation Guide Don't worry if you don't have anything installed yet! Just follow these steps or ask your assistant to help you with the installation. ### Step 1: Install Node.js #### macOS 1. Install Homebrew if not installed: ```bash /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" ``` 2. Install Node.js 18: ```bash brew install node@18 echo 'export PATH="/opt/homebrew/opt/node@18/bin:$PATH"' >> ~/.zshrc source ~/.zshrc ``` #### Windows 1. Download Node.js 18 LTS from [nodejs.org](https://nodejs.org/) 2. Run the installer 3. Open a new terminal to apply changes #### Linux (Ubuntu/Debian) ```bash curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash - sudo apt-get install -y nodejs ``` ### Step 2: Install uv and uvx #### All Operating Systems 1. Install uv: ```bash curl -LsSf https://astral.sh/uv/install.sh | sh ``` 2. Install uvx: ```bash uv pip install uvx ``` ### Step 3: Verify Installation Run these commands to verify everything is installed: ```bash node --version # Should show v18.x.x npm --version # Should show 9.x.x or higher uv --version # Should show uv installed uvx --version # Should show uvx installed ``` ### Step 4: Configure MCP Server Your assistant will help you: 1. Find your Cline settings file: - VSCode: `~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json` - Claude Desktop: `~/Library/Application Support/Claude/claude_desktop_config.json` - Windows VSCode: `%APPDATA%/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json` - Windows Claude: `%APPDATA%/Claude/claude_desktop_config.json` 2. Add this configuration: ```json { "mcpServers": { "aindreyway-mcp-neurolora": { "command": "npx", "args": ["-y", "@aindreyway/mcp-neurolora@latest"], "env": { "NODE_OPTIONS": "--max-old-space-size=256", "OPENAI_API_KEY": "your_api_key_here" } } } } ``` ### Step 5: Install Base Servers Simply ask your assistant: "Please install the base MCP servers for my environment" Your assistant will: 1. Find your settings file 2. Run the install_base_servers tool 3. Configure all necessary servers automatically After the installation is complete: 1. Close VSCode completely (Cmd+Q on macOS, Alt+F4 on Windows) 2. Reopen VSCode 3. The new servers will be ready to use > **Important:** A complete restart of VSCode is required after installing the base servers for them to be properly initialized. > **Note:** This server uses `npx` for direct npm package execution, which is optimal for Node.js/TypeScript MCP servers, providing seamless integration with the npm ecosystem and TypeScript tooling. ## Base MCP Servers The following base servers will be automatically installed and configured: - fetch: Basic HTTP request functionality for accessing web resources - puppeteer: Browser automation capabilities for web interaction and testing - sequential-thinking: Advanced problem-solving tools for complex tasks - github: GitHub integration features for repository management - git: Git operations support for version control - shell: Basic shell command execution with common commands: - ls: List directory contents - cat: Display file contents - pwd: Print working directory - grep: Search text patterns - wc: Count words, lines, characters - touch: Create empty files - find: Search for files ## 🎯 What Your Assistant Can Do Ask your assistant to: - "Analyze my code and suggest improvements" - "Install base MCP servers for my environment" - "Collect code from my project directory" - "Create documentation for my codebase" - "Generate a markdown file with all my code" ## 🛠 Available Tools ### analyze_code Analyzes code using OpenAI API and generates detailed feedback with improvement suggestions. Parameters: - `codePath` (required): Path to the code file or directory to analyze Example usage: ```json { "codePath": "/path/to/your/code.ts" } ``` The tool will: 1. Analyze your code using OpenAI API 2. Generate detailed feedback with: - Issues and recommendations - Best practices violations - Impact analysis - Steps to fix 3. Create two output files in your project: - LAST_RESPONSE_OPENAI.txt - Human-readable analysis - LAST_RESPONSE_OPENAI_GITHUB_FORMAT.json - Structured data for GitHub issues > Note: Requires OpenAI API key in environment configuration ### collect_code Collects all code from a directory into a single markdown file with syntax highlighting and navigation. Parameters: - `directory` (required): Directory path to collect code from - `outputPath` (optional): Path where to save the output markdown file - `ignorePatterns` (optional): Array of patterns to ignore (similar to .gitignore) Example usage: ```json { "directory": "/path/to/project/src", "outputPath": "/path/to/project/src/FULL_CODE_SRC_2024-12-20.md", "ignorePatterns": ["*.log", "temp/", "__pycache__", "*.pyc", ".git"] } ``` ### install_base_servers Installs base MCP servers to your configuration file. Parameters: - `configPath` (required): Path to the MCP settings configuration file Example usage: ```json { "configPath": "/path/to/cline_mcp_settings.json" } ``` ## 🔧 Features The server provides: - Code Analysis: - OpenAI API integration - Structured feedback - Best practices recommendations - GitHub issues generation - Code Collection: - Directory traversal - Syntax highlighting - Navigation generation - Pattern-based filtering - Base Server Management: - Automatic installation - Configuration handling - Version management ## 📄 License MIT License - feel free to use this in your projects! ## 👤 Author **Aindreyway** - GitHub: [@aindreyway](https://github.com/aindreyway) ## ⭐️ Support Give a ⭐️ if this project helped you!