Mediachips

MCP server for MediaChips database. Provides CRUD tools to manage media, tags, playlists, marks, and settings via the Model Context Protocol.

Requirements

• macOS (other platforms are not currently supported)

Setup

npm install

Configuration

Add to your MCP client config (e.g. Claude Desktop):

{
  "mcpServers": {
    "mediachips": {
      "command": "node",
      "args": ["/path/to/mcp-mediachips/index.js"],
      "env": {
        "MEDIACHIPS_DB_PATH": "/path/to/mediachips/db.sqlite"
      }
    }
  }
}

If MEDIACHIPS_DB_PATH is not set, it defaults to db.sqlite in the project directory.

Tools

Tool	Description
list_media	List media with pagination, sorting, and filters
get_media	Get media by ID with tags, video metadata, marks
create_media	Create a new media item
update_media	Update media (name, rating, favorite, bookmark)
delete_media	Delete a media item
list_tags	List tags with pagination and filters
get_tag	Get tag by ID with media, child/parent tags, values
create_tag	Create a new tag
update_tag	Update a tag
delete_tag	Delete a tag
add_tag_to_media	Associate a tag with media
remove_tag_from_media	Remove a tag from media
list_playlists	List all playlists
get_playlist	Get playlist with its media items
create_playlist	Create a new playlist
update_playlist	Update a playlist
delete_playlist	Delete a playlist
add_media_to_playlist	Add media to a playlist
remove_media_from_playlist	Remove media from a playlist
list_marks	List marks for a media item
create_mark	Create a timestamp mark on media
update_mark	Update a mark
delete_mark	Delete a mark
list_meta	List meta categories
list_media_types	List media types with counts
get_settings	Get application settings
update_setting	Update a setting
set_value_for_media	Set custom meta value on media
set_value_for_tag	Set custom meta value on tag
get_stats	Get database statistics
search	Search across media and tags
execute_query	Execute raw SELECT queries