← Back to Configurator

🤖 MCP Server

AI-Powered Oh My Posh Configuration

11 Tools 5 Resources 3 Prompts
📦 npm install ohmyposh-configurator

💡 What is MCP?

The Model Context Protocol (MCP) is an open standard that enables AI assistants to interact with external tools and data sources.

Our MCP server allows AI assistants like GitHub Copilot in VS Code and others to help you create and manage Oh My Posh configurations through natural language conversations.

Example:

"Create me a developer prompt with git and Python info"

→ AI generates a complete Oh My Posh configuration with appropriate segments, colors, and templates!

🎯 Key Features

  • Natural language configuration generation
  • Smart segment defaults and colors
  • Multi-format export (JSON/YAML/TOML)
  • Configuration validation with detailed errors
  • Official documentation search integration
  • Access to 103+ segments across 8 categories
  • Sample and community configuration templates

🛠️ Available Tools

The MCP server provides 11 powerful tools for configuration management:

create_configuration

Generate configs from natural language descriptions

add_segment

Add segments with smart defaults

modify_configuration

Edit existing configurations

validate_configuration

Check config validity with detailed errors

export_configuration

Convert between JSON/YAML/TOML formats

list_segments

Browse all 103+ available segments

get_segment_info

Get detailed segment documentation

list_sample_configs

View pre-built sample configurations

load_sample_config

Load specific sample configurations

search_ohmyposh_docs

Search official Oh My Posh documentation

get_ohmyposh_segment_docs

Get official segment documentation with examples

💬 Example Requests

Try these natural language requests with your AI assistant:

  • "Create a developer prompt with git and Python"
  • "Add caching to all language segments"
  • "Apply the Dracula color theme to my config"
  • "Validate my Oh My Posh configuration"
  • "Search docs for powerline symbols"
  • "Help me optimize my slow prompt"
  • "Export my configuration as YAML"

📚 Resources

The MCP server provides access to comprehensive data resources:

103+ Available Segments
8 Segment Categories
6+ Sample Configs

Segment Categories

  • System: Path, OS, Shell, Battery, Time, Execution Time
  • SCM: Git, Mercurial, SVN, Fossil, Plastic SCM
  • Languages: Node.js, Python, Go, Rust, Java, .NET, PHP, Ruby, and 20+ more
  • Cloud: AWS, Azure, GCP, Kubernetes, Docker, Terraform
  • CLI: NPM, Yarn, PNPM, Angular, React, Flutter
  • Web: IP Address, Weather, HTTP requests
  • Music: Spotify, YouTube Music, Last.fm
  • Health: Nightscout, Strava, Withings

⚙️ Setup Instructions

Get started in minutes with VS Code and GitHub Copilot:

Install from npm

The easiest way to get started — no cloning required:

npx ohmyposh-configurator

Or install globally: npm install -g ohmyposh-configurator

Configure VS Code

Add to your VS Code .vscode/mcp.json (or User Settings):

{
  "servers": {
    "ohmyposh-configurator": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "ohmyposh-configurator"]
    }
  }
}

Requires VS Code with GitHub Copilot extension and MCP support enabled.

Start Creating!

Open GitHub Copilot Chat in VS Code and start creating configurations with natural language.

Try: "Create a developer prompt with git and Python"

Alternative: Build from Source

git clone https://github.com/jamesmontemagno/ohmyposh-configurator.git
cd ohmyposh-configurator
npm install
npm run build:mcp

Then point your MCP config to dist/mcp/index.js

🌟 Use Cases

For Beginners

"Create me a nice-looking developer prompt with git and Python info"

For Advanced Users

"Add caching to all language segments with optimal durations"

For Teams

"Generate a standardized DevOps prompt for our team with AWS, kubectl, and terraform"

For Customization

"Apply the Dracula color theme to my configuration"

For Troubleshooting

"My prompt is slow - help me optimize it"

🔗 Resources

🚀 Ready to Get Started?

Build amazing Oh My Posh configurations with AI assistance

Use Visual Configurator Setup MCP Server