@aishelf/mcp-server

AIShelf MCP Server

Model Context Protocol server that provides AI models with access to workflows, rules, skills, and prompts from your connected AIShelf registries.

What is AIShelf?

AIShelf is a platform for organizing and sharing AI workflows, rules, skills, and prompts. The MCP server allows AI assistants to access your AIShelf resources directly, and choose the right resources for the given task, enhancing their responses.

Features

• 🔍 Browse Resources - List all available workflows, rules, skills, and prompts from your registries
• 📦 Fetch Resources - Retrieve specific resources to apply their instructions to your current task
• 🔄 Real-time Updates - Automatically detects new resources as you add them
• 🎯 Type-Specific Instructions - Each resource type (workflow, rule, skill, prompt) comes with appropriate context
• 🔒 Read-Only & Safe - Non-destructive operations that only read your local resources

Prerequisites

• Node.js v18.0.0 or higher (Download)
• AIShelf IDE Extension installed and configured (Get it)

Installation

No installation required! The server runs via npx:

npx @aishelf/mcp-server

Configuration

Add the AIShelf MCP server to your MCP client configuration:

{
  "mcpServers": {
    // ... other servers
    "aishelf": {
      "command": "npx",
      "args": ["-y", "@aishelf/mcp-server"]
    }
    // ... other servers
  }
}

The configuration file location varies by MCP client. Refer to your client's documentation for the specific configuration file path.

Usage

Once configured, your AI assistant will automatically have access to AIShelf resources. The AI will intelligently choose which resources to use based on your task.

Example Prompts

Here are some ways to ask your AI assistant to use AIShelf:

Let AI Choose from AIShelf:

"Check AIShelf and help me write a blog post"
"Use AIShelf to review this code for security issues"
"Look in AIShelf for a workflow to fix these Dependabot vulnerabilities"

Apply Specific Resources:

"Use my Code Style Guide for this implementation"
"Follow my Blog Post Creation workflow"
"Apply my Security Rules to review this code"

Combine Resources:

"Use my AIShelf code style guide and security rules for this feature"
"Check AIShelf for writing guidelines and help me write documentation"

Browse Available Resources:

"What AIShelf resources do I have available?"
"Show me my workflows"
"List my coding rules and skills"

How the AI Uses AIShelf

The AI assistant will:

• Automatically detect when a task matches your resources
• Browse your available workflows, rules, skills, and prompts
• Select the most relevant resources (up to 2 at a time)
• Apply their instructions to enhance responses
• Follow workflows step-by-step or apply rules throughout the session

How It Works

• AIShelf Extension - You install the AIShelf IDE extension and connect to registries
• Local Storage - Resources are stored locally on your machine
• MCP Server - This server reads your local resources and provides them to AI models
• AI Enhancement - AI assistants use the resource instructions to provide better responses

Resource Types

• Workflows - Step-by-step processes (e.g., "Blog Post Creation", "Code Review")
• Rules - Session-wide guidelines (e.g., "Code Style Guide", "Security Rules")
• Skills - Specialized capabilities (e.g., "Security Audit", "Content Optimization")
• Prompts - Reusable prompt templates (e.g., "Content Review", "Security Checklist")

Troubleshooting

No Resources Found

Error: No registries connected

Solution:

• Install the AIShelf IDE extension
• Connect to at least one registry

Resources Not Updating

Solution: The server scans resources on each request. If changes aren't appearing:

• Verify the resource files exist in your AIShelf storage directory
• Restart your MCP client to clear any caches

Configuration Files

The MCP server reads from:

• Extension Config: ~/.aishelf/config.json (created by AIShelf extension)
• Registries: ~/.aishelf/registries/ (your connected registries)

Privacy & Security

• ✅ Local-Only - All resources are stored and read from your local machine
• ✅ No External Calls - The server never sends data to external services
• ✅ Read-Only - Cannot modify or delete your resources
• ✅ Proprietary License - See license terms

Support

• Website: https://aishelf.dev
• Documentation: https://aishelf.dev/docs
• Email: [e-mail]

License

The full license agreement is available at https://aishelf.dev/license.

About

Part of the AIShelf platform for organizing and sharing AI instructions.

Ready to enhance your AI assistant? Install the AIShelf extension and start using your AI resources today!