MCPgee
MCPgee
MCPgeeMCPgee

Beatos

v1.0.0•File Systems•stable

Local-first beat library for music producers. MCP server (Claude Code / Claude Desktop) for AI-driven cataloging, tagging, and multi-platform publishing.

ai-toolsanthropicaudio-metadatabeat-makerbpm-detection
Share:
11
Stars
0
Downloads
0
Weekly
0/5
View on GitHub

What is Beatos?

Beatos is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to local-first beat library for music producers. mcp server (claude code / claude desktop) for ai-driven cataloging, tagging, and multi-platform publishing.

Local-first beat library for music producers. MCP server (Claude Code / Claude Desktop) for AI-driven cataloging, tagging, and multi-platform publishing.

This server falls under the File Systems category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • Local-first beat library for music producers. MCP server (Cl

Use Cases

Music beat library management
BPM detection and multi-platform publishing
averatec0773

Maintainer

LicenseApache-2.0
Languagetypescript
Versionv1.0.0
UpdatedMay 22, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux
View SourceBrowse All Servers

Installation

Manual Installation

npx beatos

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Beatos

Beatos is a local-first beat library for music producers that includes a fully featured MCP server allowing AI assistants like Claude to catalog, tag, search, and publish audio beats. It provides 24 free MCP tools (and 29 in the Pro tier) covering the full production lifecycle from metadata enrichment and BPM-based filtering to multi-platform publishing, all backed by a local SQLite database with an approval-gated write flow to prevent accidental changes.

Prerequisites

  • Node.js 22 LTS or newer
  • Python 3.11.x
  • uv package manager (brew install uv on macOS, or pipx install uv)
  • macOS 12+ or Windows 10+ for the desktop Electron app (Linux supported for browser/dev mode)
  • Claude Desktop, Claude Code, or another MCP-compatible client
1

Clone the repository

Clone the Beatos repository to your local machine.

git clone https://github.com/averatec0773/beatos.git
cd beatos
2

Install Python and Node dependencies

Use make sync to install all Python dependencies via uv, then install Electron app Node modules.

make sync
cd apps/desktop && npm install && cd ../..
3

Launch the BeatOS application

Start the desktop (Electron + Python sidecar) or browser version. The MCP server requires the BeatOS sidecar to be running.

# Desktop mode (Electron)
make dev

# Browser mode (SPA at http://127.0.0.1:8765)
make web
4

Configure the MCP server for your AI client

Use the in-app Settings → AI Integration for one-click setup (Claude Desktop, Claude Code, Codex), or manually add the configuration using the absolute path to the repo.

{
  "mcpServers": {
    "beatos": {
      "command": "uv",
      "args": ["run", "--directory", "/absolute/path/to/beatos", "beatos-mcp"]
    }
  }
}
5

Verify connection and explore tools

After connecting, ask Claude to list available tools or ping the server to confirm the MCP connection is live.

Beatos Examples

Client configuration

claude_desktop_config.json entry for Beatos using uv to run the beatos-mcp entry point. Replace the path with the absolute path to your cloned repository.

{
  "mcpServers": {
    "beatos": {
      "command": "uv",
      "args": ["run", "--directory", "/Users/yourname/beatos", "beatos-mcp"]
    }
  }
}

Prompts to try

Use these prompts with Claude after connecting to the Beatos MCP server to manage and enrich your beat library.

- "Tag every beat above 140 BPM that has no genre with 'Trap' or 'Drill' based on the title and cover art — show me the diff before applying"
- "Search my library for all beats with 'dark' in the title and export their metadata to CSV"
- "Create a new list called 'Portfolio' and add my top 10 beats to it"
- "List all tracks missing a BPM value so I can review them"
- "Set the license tier for all beats in the 'Leasing' list to non-exclusive"

Troubleshooting Beatos

uv command not found when starting the MCP server

Install uv with 'brew install uv' on macOS or 'pipx install uv' on other platforms. Verify with 'which uv'. If installed via pipx, ensure ~/.local/bin is on your PATH.

MCP server connects but returns errors on write operations

All write tools in Beatos default to a propose-then-confirm flow. Check the Agent Actions panel in the BeatOS app for pending approval requests. You can also adjust write permissions in Settings → AI Integration.

Desktop app fails to start the Python sidecar

Run 'make sync' again to ensure Python dependencies are installed for the correct Python 3.11.x version. Check logs with 'npm run logs:tail' from the apps/desktop directory.

Frequently Asked Questions about Beatos

What is Beatos?

Beatos is a Model Context Protocol (MCP) server that local-first beat library for music producers. mcp server (claude code / claude desktop) for ai-driven cataloging, tagging, and multi-platform publishing. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Beatos?

Follow the installation instructions on the Beatos GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Beatos?

Beatos works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Beatos free to use?

Yes, Beatos is open source and available under the Apache-2.0 license. You can use it freely in both personal and commercial projects.

Learn More About MCP Servers

Getting Started with MCP

Set up your first MCP server in minutes

MCP Setup Guide

Configure MCP in Claude, Cursor & VS Code

All MCP Tutorials

18+ hands-on guides for developers

MCP FAQ

40+ answers about Model Context Protocol

Beatos Alternatives — Similar File Systems Servers

Looking for alternatives to Beatos? Here are other popular file systems servers you can use with Claude, Cursor, and VS Code.

Electerm

★ 14.1k

📻Terminal/ssh/sftp/ftp/telnet/serialport/RDP/VNC/Spice client(linux, mac, win)

Plik

★ 1.8k

Plik is a temporary file upload system (Wetransfer like) in Go.

Kordoc

★ 957

An MCP server that parses South Korean document formats like HWP, HWPX, and PDF into Markdown. It features specialized table reconstruction and security-hardened extraction optimized for administrative and public institution files.

macOS Automator

★ 801

A Model Context Protocol server that enables execution of AppleScript and JavaScript for Automation scripts on macOS, allowing programmatic control of applications and system functions through a rich knowledge base of pre-defined scripts.

PDF Reader

★ 723

Enables reading, searching, and metadata extraction from PDF files without loading the entire content into the context window. It provides efficient tools for text cleaning, page-specific extraction, and context-aware search results.

Filesystem MCP Server

★ 643

Provides comprehensive filesystem operations (read, write, list, create, delete, move files and directories) through the Model Context Protocol with Streamable HTTP transport and built-in security through configurable root directory restrictions.

Browse More File Systems MCP Servers

Explore all file systems servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

File SystemsBrowse All Servers

Quick Config Preview

{ "mcpServers": { "beatos": { "command": "npx", "args": ["-y", "beatos"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Beatos?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides
Explore All ServersRead Our Guides