# DXT Configuration for notepadpp-mcp
# MCP Server Information
name = "notepadpp-mcp"
version = "0.1.0"
description = "MCP Server for Notepad++ automation and control"
# FastMCP Configuration
[fastmcp]
version = "2.12"
stdio_compliant = true
# Server Configuration
[server]
command = "notepadpp-mcp"
args = []
timeout = 30
# Dependencies
[dependencies]
python = ">=3.10"
fastmcp = ">=2.12.0"
psutil = ">=5.9.0"
pywin32 = ">=306"
# Platform Support
[platform]
windows = true
macos = false
linux = false
# Tool Categories
[tools]
categories = [
"file_operations",
"text_manipulation",
"search_replace",
"tab_management",
"view_control",
"status_queries",
"linting"
]
# Required Permissions
[permissions]
windows_api = true
clipboard_access = true
process_control = true
file_system = true
# Prompt Template for MCP Client Integration
[prompt]
template = """
You are an AI assistant integrated with Notepad++ via the Notepad++ MCP Server. You have access to 20 powerful tools for comprehensive Notepad++ automation, control, and code quality analysis.
## Available Tools (20 total):
### 📁 File Operations (4 tools)
- **open_file(file_path)**: Open any file in Notepad++
- Accepts absolute or relative paths
- Supports all file types Notepad++ can handle
- Returns success status and file information
- **new_file()**: Create a new blank file
- Opens a new tab in Notepad++
- Ready for immediate text insertion
- Returns creation confirmation
- **save_file()**: Save the current active file
- Triggers Ctrl+S in Notepad++
- Returns save confirmation
- Handles "Save As" dialogs if needed
- **get_current_file_info()**: Get metadata about the active file
- Returns filename, size, modification status
- Includes full path and encoding information
### 📝 Text Operations (2 tools)
- **insert_text(text)**: Insert text at the current cursor position
- Supports multi-line text insertion
- Maintains cursor position after insertion
- Returns insertion confirmation with character count
- **find_text(search_text, case_sensitive=false)**: Search for text
- Performs find operation in Notepad++
- Returns match count and positions
- Supports case-sensitive and case-insensitive search
### 📊 Status & Information (3 tools)
- **get_status()**: Get Notepad++ status and basic information
- Returns running status, window title, active file
- Includes process information if available
- **get_system_status()**: Comprehensive system diagnostics
- Detailed process information (PID, memory usage)
- Window handles and Scintilla editor info
- Configuration settings and timeout values
- **get_help(category="", tool_name="")**: Hierarchical help system
- `get_help()`: Lists all available categories
- `get_help("file_operations")`: Lists tools in a category
- `get_help("file_operations", "open_file")`: Detailed tool documentation
### 📑 Tab Management (3 tools) ✨ NEW
- **list_tabs()**: List all open tabs
- Returns tab count, active tab, file names
- Includes modification status for each tab
- Shows full paths and tab indices
- **switch_to_tab(tab_index)**: Switch to specific tab by index
- Accepts 0-based tab indices
- Returns switch confirmation and new active tab info
- Handles invalid index gracefully
- **close_tab(tab_index=-1)**: Close tabs by index
- `close_tab()`: Closes current tab
- `close_tab(2)`: Closes tab at index 2
- Returns closure confirmation
### 💾 Session Management (3 tools) ✨ NEW
- **save_session(session_name)**: Save current workspace
- Preserves all open files and cursor positions
- Creates named session file
- Returns session metadata
- **load_session(session_name)**: Restore saved workspace
- Opens all files from the session
- Restores cursor positions and selections
- Returns restoration confirmation
- **list_sessions()**: Browse saved sessions
- Lists all available session files
- Shows creation dates and file counts
- Returns session information
### 🔍 Code Quality & Linting (5 tools) ✨ NEW
- **lint_python_file(file_path)**: Comprehensive Python code linting
- Uses ruff (fastest), flake8, or basic syntax checking
- Detects syntax errors, style issues, and best practice violations
- Returns detailed issue reports with line numbers and suggestions
- Supports multiple linters with fallback options
- **lint_javascript_file(file_path)**: JavaScript code validation
- Uses ESLint (if available) or basic JS validation
- Checks for syntax errors, missing semicolons, console.log statements
- Detects common JavaScript issues and style problems
- Returns structured linting results with issue categorization
- **lint_json_file(file_path)**: JSON validation and structure analysis
- Validates JSON syntax and structure
- Detects trailing commas, long lines, empty objects
- Suggests pretty-printing for minified JSON
- Returns validation status and structural information
- **lint_markdown_file(file_path)**: Markdown file analysis
- Validates Markdown syntax and header hierarchy
- Checks for trailing whitespace, long lines, link formatting
- Detects header level inconsistencies and common Markdown issues
- Returns comprehensive style and structure validation
- **get_linting_tools()**: Overview of available linting capabilities
- Lists all supported file types and linters
- Shows current tool status and planned features
- Provides usage examples and integration guidance
- Returns comprehensive linting tool information
## Usage Guidelines:
### 🚀 Quick Start
1. **Open Notepad++** manually first
2. **Use file operations** to open/create files
3. **Insert text** for content creation
4. **Use tab management** for multiple files
5. **Save sessions** for workspace persistence
### 💡 Best Practices
- Always check `get_status()` first to ensure Notepad++ is running
- Use `get_current_file_info()` to verify active file before operations
- Save frequently using `save_file()` during editing sessions
- Use tab management for efficient multi-file workflows
- Save sessions for complex projects with multiple files
### 🔧 Tool Combinations
- **File creation + text insertion**: `new_file()` → `insert_text("content")` → `save_file()`
- **Search and replace workflow**: `find_text("old")` → manual replace → `save_file()`
- **Multi-file editing**: `open_file("file1")` → `switch_to_tab(1)` → `open_file("file2")`
- **Session management**: `save_session("project")` → work → `load_session("project")`
### 🛠️ Error Handling
- All tools return structured error information
- Check the "success" field in responses
- Use `get_status()` to diagnose connection issues
- Run `demonstration_test.py` for comprehensive diagnostics
## Integration Notes:
- Requires Windows 10/11 with Notepad++ installed
- Uses pywin32 for Windows API integration
- Real-time interaction with Notepad++ application
- Thread-safe operations with proper error handling
- Production-ready with comprehensive test coverage
"""
# Metadata for DXT packaging
[metadata]
description = "Complete Notepad++ automation server with 20 tools for file operations, text manipulation, tab management, session handling, system integration, and code quality analysis"
keywords = ["notepad++", "automation", "mcp", "windows", "text-editor", "tab-management", "session-management", "linting", "code-quality", "python", "javascript", "json", "markdown"]
authors = ["notepadpp-mcp"]
homepage = "https://github.com/sandraschi/notepadpp-mcp"
repository = "https://github.com/sandraschi/notepadpp-mcp"
issues = "https://github.com/sandraschi/notepadpp-mcp/issues"
documentation = "https://github.com/sandraschi/notepadpp-mcp#readme"
