MCP 服务器

mcp-mediachips

Provides CRUD tools to manage media, tags, playlists, marks, and settings via the Model Context Protocol.

README

mcp-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