AI-MCP Framework VS Code Extension
Developer tools for building AI-integrated applications with the AI-MCP Framework (AIMF).
Features
🚀 Integrated MCP Server
- One-click MCP server management - Start, stop, and restart the AIMF MCP server directly from VS Code
- Auto-discovery - Automatically detects and connects to the MCP server in your project
- Real-time status monitoring - View server status, uptime, and connection health
- Tool execution - Call MCP tools directly from the command palette
- Output logging - View server logs in the dedicated output channel
🗂️ Project Explorer
- Discover AIMF projects in your workspace
- View neural manifests and package configurations
- Navigate project structure easily
- Quick access to common commands
- Create new projects with templates
- Generate components (tools, resources, prompts, Lit components)
- Start/stop development servers
🔍 Component Discovery
- Automatically discover neural components in your codebase
- View tools, resources, prompts, and components
- Jump to component definitions
🔌 Connection Management
- Test NCP gateway connections
- Monitor connection status and latency
- Manage multiple connections
📝 IntelliSense & Snippets
- Code completion for AIMF imports
- Snippets for common patterns
- Neural manifest validation
Commands
| Command |
Description |
AIMF: Create New Project |
Create a new AIMF project with templates |
AIMF: Generate Component |
Generate a neural tool, resource, prompt, or component |
AIMF: Start Development Server |
Start the dev server for the current workspace |
AIMF: Stop Development Server |
Stop all running dev servers |
AIMF: Start MCP Server |
Start the AIMF MCP server |
AIMF: Stop MCP Server |
Stop the AIMF MCP server |
AIMF: Restart MCP Server |
Restart the AIMF MCP server |
AIMF: Show MCP Server Status |
Display server status and uptime |
AIMF: List MCP Tools |
Browse and test available MCP tools |
AIMF: Call MCP Tool |
Execute an MCP tool with custom arguments |
AIMF: Open MCP Server Output |
View MCP server logs |
AIMF: Open Dashboard |
Open the AIMF dashboard panel |
AIMF: Validate Neural Manifest |
Validate the current neural.manifest.json file |
AIMF: Test NCP Connection |
Test connectivity to an NCP gateway |
AIMF: Refresh Explorer |
Refresh the AIMF explorer views |
Keyboard Shortcuts
| Shortcut |
Command |
Ctrl+Shift+G / Cmd+Shift+G |
Generate Component |
Configuration
| Setting |
Default |
Description |
aimf.defaultTemplate |
full-stack |
Default project template |
aimf.autoStartDevServer |
false |
Auto-start dev server on project open |
aimf.autoStartMcpServer |
false |
Auto-start MCP server on project open |
aimf.mcpServerPort |
3000 |
Port for the MCP server |
aimf.mcpServerHost |
localhost |
Host for the MCP server |
aimf.mcpServerTransport |
ncp |
Transport mode (stdio, http, ncp) |
aimf.ncpEndpoint |
http://localhost:3000 |
Default NCP gateway endpoint |
aimf.showWelcomeOnStartup |
true |
Show welcome page on startup |
aimf.telemetry |
false |
Enable anonymous usage telemetry |
Project Templates
- Full Stack: Complete AIMF application with frontend and backend
- Frontend: Web frontend using Lit components
- Backend: NCP server backend
- CLI: Command-line interface tool
Snippets
TypeScript Snippets
| Prefix |
Description |
aimf-tool |
Create a Neural Tool class |
aimf-resource |
Create a Neural Resource class |
aimf-prompt |
Create a Neural Prompt class |
aimf-component |
Create a Lit web component |
aimf-ncp-request |
Create an NCP request |
Neural Manifest Snippets
| Prefix |
Description |
aimf-manifest |
Create a neural.manifest.json file |
aimf-tool-def |
Add a tool definition |
aimf-resource-def |
Add a resource definition |
aimf-prompt-def |
Add a prompt definition |
Requirements
- VS Code 1.85.0 or higher
- Node.js 18.0.0 or higher
- pnpm (recommended) or npm
Getting Started
- Install the extension from the VS Code Marketplace
- Open a folder or create a new project with
AIMF: Create New Project
- The extension activates automatically when it detects a
neural.manifest.json file
- Use the AIMF panel in the Activity Bar to explore your project
- Start the MCP server with
AIMF: Start MCP Server for full functionality
MCP Server Integration
The extension integrates seamlessly with the AIMF MCP server, providing:
- Project Management:
validate_manifest, get_project_info, list_components
- Code Generation:
generate_component, generate_manifest
- NCP Operations:
test_ncp_connection, send_ncp_message
- Data Storage:
store_data, retrieve_data, search_data
- Development:
get_package_info, check_dependencies
- Basic Utilities:
hello, echo
Quick Start with MCP
# Install the MCP server globally
npm install -g @aimf/mcp-server
# Or use it from your project
pnpm add -D @aimf/mcp-server
Then in VS Code:
- Open Command Palette (
Ctrl+Shift+P)
- Run:
AIMF: Start MCP Server
- Use:
AIMF: List MCP Tools to see available tools
- Call any tool with:
AIMF: Call MCP Tool
The MCP server auto-discovers your project structure and provides AI-powered assistance for:
- Validating neural manifests
- Generating boilerplate code
- Testing NCP connections
- Managing neural components
- Storing and retrieving data with semantic search
Development
# Clone the repository
git clone https://github.com/aimf/aimf-vscode.git
cd aimf-vscode
# Install dependencies
pnpm install
# Compile
pnpm compile
# Run in development mode
pnpm watch
# Package the extension
pnpm package
License
MIT
| |
