mcp-ai-extension

Name: mcp-ai-extension
Availability: InStock
Author: aigentic

MCPサーバーAI拡張は、モダンなUIと強力な機能を持つツールで、モデルコンテキストプロトコル（MCP）に対応しています。PyQt5を使用した美しいダークテーマのインターフェース、ファイル管理機能、画像サポート、マルチ言語対応などが特徴です。また、会話の継続やワークスペースに基づく相対パス処理も可能で、パフォーマンスも最適化されています。

GitHub

GitHubスター

ユーザー評価

未評価

フォーク

イシュー

閲覧数

お気に入り

README

🚀 MCP Server AI extension

Modern AI extension tool with advanced UI and powerful features for Model Context Protocol (MCP)

✨ Features

🎨 Modern Dark Theme UI - Beautiful, responsive interface with PyQt5
📁 Advanced File Management - Browse, select, and attach files/folders with workspace support
🖼️ Image Support - Drag & drop images, paste from clipboard, with preview functionality
🌐 Multi-language Support - English and Vietnamese translations
💾 Smart Persistence - Remember your preferences, workspace, and attached files
🔄 Continue Conversations - Seamless chat continuation with smart state management
🎯 Workspace-Aware - Intelligent relative path handling for better code context
⚡ Fast & Responsive - Optimized performance with async operations

🚀 Quick Start

Installation

# Install dependencies
pip install -r requirements.txt

# Run the tool directly
python -m AI_EXTENSION_tool

Usage with MCP

Add to your MCP client configuration:

{
  "mcpServers": {
    "ai-extension": {
      "command": "python",
      "args": ["-m", "AI_EXTENSION_tool"],
      "cwd": "/path/to/mcp-ai-extension"
    }
  }
}

📋 How It Works

Basic Workflow

Launch Tool: Call the MCP tool or run directly
Enter Message: Type your message in the text area
Attach Files (Optional): Use the file browser to select files/folders
Attach Images (Optional): Drag & drop or select images
Configure Options: Set continue conversation and other preferences
Send: Submit your message with all attachments

Advanced Features

Workspace Management

Set a workspace root directory for consistent relative paths
All file attachments are relative to your workspace
Workspace state is remembered between sessions

File Attachments

Browse and select multiple files and folders
Supports all file types with intelligent type detection
Workspace-relative paths for better code context
Multi-select with Ctrl+Click and Shift+Click

Image Attachments

Drag & drop images directly into the interface
Paste images from clipboard (Ctrl+V in text area)
Support for PNG, JPG, GIF, BMP, WebP formats
Image previews with click-to-enlarge functionality
Smart duplicate detection

Continue Conversations

Enable "Continue conversation" to keep the chat active
Tool automatically reopens after AI responds
Perfect for multi-step tasks and iterative development

🔧 Configuration

The tool automatically saves your preferences:

Window size and position
Language preference
Workspace directory
Attached files state
Continue conversation setting
Image save preferences

📖 Output Format

AI extension Tool

The tool outputs structured data for AI processing:

# Call "AI_EXTENSION" to launch the UI

With File Attachments

Your message content

<AI_EXTENSION_ATTACHED_FILES>
FOLDERS:
- src/components

FILES:
- src/utils/helper.js
- config/settings.json

</AI_EXTENSION_ATTACHED_FILES>

<AI_EXTENSION_WORKSPACE>my-project</AI_EXTENSION_WORKSPACE>
<AI_EXTENSION_CONTINUE_CHAT>true/false</AI_EXTENSION_CONTINUE_CHAT>

With Images

When images are attached, they're included as base64 data in the response for AI processing.

🏗️ Project Structure

mcp-ai-extension/
├── AI_EXTENSION_tool/       # Main package
│   ├── core/                  # Core functionality
│   │   ├── dialog.py         # Main UI dialog
│   │   ├── config.py         # Configuration management
│   │   └── mcp_handler.py    # MCP integration
│   ├── ui/                   # UI components
│   │   ├── file_dialog.py    # File selection dialog
│   │   ├── image_attachment.py # Image handling
│   │   └── styles.py         # UI styling
│   └── utils/                # Utilities
│       ├── translations.py   # Multi-language support
│       └── file_utils.py     # File operations
├── user_images/              # Stored images
├── pyproject.toml           # Package configuration
└── README.md               # This file

🐛 Troubleshooting

Common Issues

Import Errors: Make sure all dependencies are installed
```
pip install -r requirements.txt
```
PyQt5 Issues: Install PyQt5 system dependencies
- Try python -m AI_EXTENSION_tool instead
Permission Errors: Ensure write access to the project directory
Image Issues: Check that image files are in supported formats (PNG, JPG, GIF, BMP, WebP)