Systemprompt

🚀 SystemPrompt Agent Server

A specialized Model Context Protocol (MCP) server that enables you to create, manage, and scale AI agents through a powerful prompt and tool management system. This server integrates with systemprompt.io to provide seamless creation, management, and version control of system prompts.

Official Website | Documentation | Blog | Get API Key

An API key is required to run. Get an API Key

✨ Features

• Voice Interaction: Supports real-time voice conversations through the microphone.
• Multimodal Input: Accepts various input forms such as text, images, and audio.
• Tool Execution: Comes with a variety of built - in utility tools, including calculators, translators, image generators, etc.
• Workflow Automation: Supports automated processes for complex tasks.
• Plugin Extension: Allows adding more features through plugins.

📦 Installation and Configuration

1. Install Dependencies

npm install

2. Build the Server

npm run build

3. Development Mode (Auto - Rebuild)

npm run watch

4. Manual Installation Configuration Example

On MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json On Windows: %APPDATA%/Claude/claude_desktop_config.json%

Add the following content to claude_desktop_config.json:

{
  "mcpServers": {
    "systemprompt-agent-server": {
      "command": "/path/to/systemprompt-agent-server/build/index.js"
    }
  }
}

5. Debugging

Since the MCP server communicates via standard input and output, debugging can be challenging. We recommend using the MCP Inspector:

npm run inspector

The inspector will provide a URL for you to access the debugging tool in your browser.

💻 Usage Examples

Basic Usage

const { Agent } = require('@systemprompt/core');

async function main() {
    const agent = new Agent();
    await agent.start();
    
    // Create a prompt for a simple calculator
    const calculatorPrompt = `You are a professional calculator. Based on my input, return the calculation result.
    Input examples:
    1. 10 + 20
    2. 30 - 5
    3. 6 * 7
    4. 8 / 2`;
    
    // Add the prompt to the queue
    agent.addPrompt(calculatorPrompt);
    
    // Process user input and return the result
    const result = await agent.processInput('10 + 20');
    console.log(result); // Output: 30
    
    await agent.stop();
}

main().catch(console.error);

Advanced Usage

const { Agent } = require('@systemprompt/core');

async function main() {
    const agent = new Agent();
    await agent.start();
    
    // Add a prompt for an image generator
    const imageGeneratorPrompt = `You are a professional image generator. Based on my description, generate the corresponding image.
    Input examples:
    - 'A cute kitten'
    - 'A beautiful forest'`;
    
    // Add the prompt to the queue
    agent.addPrompt(imageGeneratorPrompt);
    
    // Generate an image
    const image = await agent.generateImage('A cute kitten');
    console.log(image.url); // Output: Image URL
    
    await agent.stop();
}

main().catch(console.error);

📚 Documentation and Resources

• Multimodal MCP Client - An MCP client with voice support.
• systemprompt.io Documentation

If you have any questions or feedback, please feel free to contact our team.