{"id":50187766,"url":"https://github.com/jeeftor/abs-mcp","last_synced_at":"2026-05-25T11:04:53.304Z","repository":{"id":359009656,"uuid":"1244100656","full_name":"jeeftor/abs-mcp","owner":"jeeftor","description":"Model Context Protocol server for inspecting and safely operating Audiobookshelf instances","archived":false,"fork":false,"pushed_at":"2026-05-20T01:10:04.000Z","size":127,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2026-05-20T04:24:51.311Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jeeftor.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-05-20T00:58:53.000Z","updated_at":"2026-05-20T01:10:07.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/jeeftor/abs-mcp","commit_stats":null,"previous_names":["jeeftor/abs-mcp"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/jeeftor/abs-mcp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jeeftor%2Fabs-mcp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jeeftor%2Fabs-mcp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jeeftor%2Fabs-mcp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jeeftor%2Fabs-mcp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jeeftor","download_url":"https://codeload.github.com/jeeftor/abs-mcp/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jeeftor%2Fabs-mcp/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33471530,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-25T06:32:55.349Z","status":"ssl_error","status_checked_at":"2026-05-25T06:32:35.322Z","response_time":57,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-05-25T11:04:48.028Z","updated_at":"2026-05-25T11:04:53.284Z","avatar_url":"https://github.com/jeeftor.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003cimg src=\"docs/assets/abs-mcp-logo.svg\" width=\"112\" alt=\"Audiobookshelf MCP logo\"\u003e\n\u003c/p\u003e\n\n\u003ch1 align=\"center\"\u003eAudiobookshelf MCP Server\u003c/h1\u003e\n\n\u003cp align=\"center\"\u003e\n  A Go MCP server for inspecting and safely operating Audiobookshelf libraries.\n\u003c/p\u003e\n\n`abs-mcp` exposes safe, typed MCP tools and resources for agents that need to\ninspect Audiobookshelf libraries, diagnose scans, and optionally trigger bounded\nmaintenance workflows.\n\n## Table of Contents\n\n- [Highlights](#highlights)\n- [Audiobook Organizer Compatibility](#audiobook-organizer-compatibility)\n- [AI Generated Comparison - Last updated 2026-05-20](#ai-generated-comparison---last-updated-2026-05-20)\n- [Quick Start](#quick-start)\n- [MCP Surface](#mcp-surface)\n- [Configuration](#configuration)\n- [Safety](#safety)\n- [Installation](#installation)\n  - [Client Configs](#client-configs)\n- [Local Development](#local-development)\n- [Tests](#tests)\n- [CI and Releases](#ci-and-releases)\n- [MCP Registry](#mcp-registry)\n\n## Highlights\n\n- Read-only by default; scan and cleanup tools require `ABS_READ_ONLY=false`.\n- Ships as a local stdio MCP server from a single Go binary or Docker image;\n  Streamable HTTP is a good future fit for hosted or multi-client deployments.\n- Supports env vars, Docker-style env files, extra headers, and custom TLS CA\n  bundles.\n- Includes source-backed Audiobookshelf API inventory resources and repeatable\n  fixture tests.\n- Publishes release binaries and a GHCR image suitable for official MCP\n  Registry metadata.\n\n## Audiobook Organizer Compatibility\n\nI built this MCP server to work especially well alongside\n[jeeftor/audiobook-organizer](https://github.com/jeeftor/audiobook-organizer).\nWhile it exposes the normal Audiobookshelf MCP tools for inspecting libraries,\nitems, metadata, and server state, one of its most useful workflows is auditing\nwhether books are actually organized the way you expect on disk.\n\nThe `abs_find_misorganized_items` tool checks Audiobookshelf item paths against\nsupported folder layout conventions, including author/title and\nauthor/series/title structures. It is audit-only, so it reports likely\nmisconfigured or misplaced books without moving or deleting files. That makes it\na good companion to Audiobook Organizer: use this MCP server to identify layout\nproblems from Audiobookshelf's perspective, then use Audiobook Organizer to\nclean up or standardize the underlying files.\n\n\u003c!-- AI-GENERATED-COMPARISON:START --\u003e\n## AI Generated Comparison - Last updated 2026-05-20\n\nThis comparison is generated from public project READMEs, registry pages, and\nthis repository's current docs. It is descriptive rather than a recommendation.\n\nMutating versus non-mutating coverage:\n\n- `jeeftor/abs-mcp` exposes read-only inspection, search, metadata-object,\n  layout-audit, resources, and prompts by default. Scan, cleanup, cover, and\n  chapter tools can mutate Audiobookshelf state only when `ABS_READ_ONLY=false`;\n  destructive operations also require exact confirmation strings.\n- `michaeldvinci/audiobookshelf-mcp` exposes a broad management surface with\n  read tools plus mutating operations such as library, collection, playlist,\n  progress, and backup actions. No public README evidence was found for a\n  global default read-only gate during this pass.\n- `sandymac/audiobookshelf-mcp` is mostly read/query oriented, with optional\n  progress and bookmark mutation tools that are disabled by default.\n- `sierikov/audiobookshelf-mcp` presents a read-only browsing, search, progress,\n  and stats surface.\n- `ForceConstant/audiobookshelf_mcp` appears to be generated from\n  Audiobookshelf OpenAPI material; mutating coverage and safety gates were not\n  determinable from the public README.\n\nCandidate gaps from this comparison:\n\n- [#2](https://github.com/jeeftor/abs-mcp/issues/2): Add playback progress and\n  bookmark MCP tools. Other servers expose progress/session inspection, and\n  `sandymac/audiobookshelf-mcp` exposes optional progress/bookmark mutations.\n- [#3](https://github.com/jeeftor/abs-mcp/issues/3): Add richer author, series,\n  and collection read tools. Public peers expose broader browsing in these\n  areas than this server currently documents.\n- [#4](https://github.com/jeeftor/abs-mcp/issues/4): Investigate safely gated\n  backup and server-admin MCP tools. At least one public peer exposes backup\n  creation, but any admin operation here should be source-verified,\n  fixture-tested, and gated.\n- [#5](https://github.com/jeeftor/abs-mcp/issues/5): Investigate Streamable HTTP\n  transport support. Public peers include HTTP/SSE or generated Streamable HTTP\n  variants, while this server currently focuses on stdio.\n\n| Server | Shape | Confirmed strengths | Safety posture | Difference from `jeeftor/abs-mcp` |\n| --- | --- | --- | --- | --- |\n| [`michaeldvinci/audiobookshelf-mcp`](https://github.com/michaeldvinci/audiobookshelf-mcp) | Go stdio server with release binaries. | Broad general Audiobookshelf management, including libraries, items, authors, collections, playlists, user info, sessions, podcasts, progress updates, and backups. | Exposes mutating tools; no global default read-only gate was found in the public README during this comparison pass. | Broader generic management surface, but less conservative. No public evidence was found for a misorganized-file audit, source-backed API inventory, MCP resources/prompts, cover removal/update, or chapter update tooling. |\n| [`sandymac/audiobookshelf-mcp`](https://github.com/sandymac/audiobookshelf-mcp) | Rust server with stdio plus HTTP/SSE support. | Read/query surface for libraries, search, progress, stats, recent sessions, and optional progress/bookmark mutations. | Mutating tools are disabled by default and must be explicitly enabled. HTTP mode recommends bearer auth and TLS proxying. | Similar safety model, but narrower feature scope. No public evidence was found for metadata, cover, chapter repair tools, organizer-oriented audits, or fixture/API-inventory workflows. |\n| [`sierikov/audiobookshelf-mcp`](https://github.com/sierikov/audiobookshelf-mcp) | Go server with read-oriented tooling and release binaries. | Read-only browsing and search across libraries, items, progress, stats, sessions, series, authors, and collections. | Public README presents it as read-only. | Useful inspection surface, but not a controlled repair workflow. No public evidence was found for mutating metadata, cover, chapter, cleanup, or organizer-focused audit tooling. |\n| [`ForceConstant/audiobookshelf_mcp`](https://github.com/ForceConstant/audiobookshelf_mcp) | Generated OpenAPI MCP bridge with streamable HTTP and Docker-oriented files. | Broad generated API exposure from Audiobookshelf OpenAPI material. | Not determinable from the public README; generated API exposure may include mutating endpoints, but the README does not enumerate safety controls. | Less curated and less operator-specific. This project intentionally exposes bounded, typed tools with read-only gating and fixture-backed behavior checks instead of exposing every route directly. |\n\nWeak or placeholder hits, such as\n[`schmidt-software/mcp-audiobookshelf`](https://github.com/schmidt-software/mcp-audiobookshelf),\nwere excluded when no implementation or feature evidence was available.\n\u003c!-- AI-GENERATED-COMPARISON:END --\u003e\n\n## Quick Start\n\nRun a downloaded release binary over MCP stdio:\n\n```bash\nABS_BASE_URL=http://localhost:13378 \\\nABS_API_KEY=... \\\nABS_READ_ONLY=true \\\n/path/to/abs-mcp\n```\n\nOr run the container image:\n\n```bash\ndocker run --rm -i \\\n  -e ABS_BASE_URL=http://host.docker.internal:13378 \\\n  -e ABS_API_KEY=... \\\n  -e ABS_READ_ONLY=true \\\n  ghcr.io/jeeftor/abs-mcp:0.1.1\n```\n\nFor client-specific snippets, see [Client Configs](#client-configs).\n\n## MCP Surface\n\n### Tools\n\nThe server exposes all registered tools in the README, grouped by whether they\ncan change Audiobookshelf state.\n\nRead-only tools:\n\n- `abs_health_check`\n- `abs_list_libraries`\n- `abs_get_library`\n- `abs_list_library_items`\n- `abs_get_library_item`\n- `abs_search_library`\n- `abs_get_library_stats`\n- `abs_get_filter_data`\n- `abs_get_item_metadata_object`\n- `abs_find_misorganized_items`\n\nImplemented mutating tools:\n\n- `abs_scan_library`\n- `abs_scan_library_and_wait`\n- `abs_scan_item`\n- `abs_update_item_cover`\n- `abs_remove_item_cover`\n- `abs_update_item_chapters`\n- `abs_remove_library_items_with_issues`\n\nPlanned mutating tools advertised for discovery:\n\n- `abs_update_item_metadata`\n- `abs_match_item`\n- `abs_update_item_tracks`\n- `abs_create_collection`\n- `abs_update_collection`\n- `abs_delete_collection`\n- `abs_add_collection_item`\n- `abs_remove_collection_item`\n- `abs_create_playlist`\n- `abs_update_playlist`\n- `abs_delete_playlist`\n- `abs_add_playlist_item`\n- `abs_remove_playlist_item`\n\nMutating tools are blocked by default because `ABS_READ_ONLY` defaults to\n`true`. Scan tools, issue cleanup, `abs_update_item_cover`,\n`abs_remove_item_cover`, and `abs_update_item_chapters` are implemented.\nRemaining planned mutating tools, including broad metadata updates and item\nmatching, are advertised for discovery but return a not-implemented error after\nread-only and confirmation checks until their ABS source and fixture behavior\nare verified.\n\n### Resources\n\n- `abs://server/info`\n- `abs://libraries`\n- `abs://libraries/{library_id}`\n- `abs://libraries/{library_id}/items?limit=...\u0026offset=...`\n- `abs://libraries/{library_id}/stats`\n- `abs://libraries/{library_id}/filterdata`\n- `abs://items/{item_id}`\n- `abs://items/{item_id}/metadata-object`\n- `abs://api-inventory/current`\n- `abs://fixture/status`\n\n### Prompts\n\n- `abs_library_audit`\n- `abs_scan_troubleshooting`\n- `abs_api_update_review`\n\nSee [docs/tools.md](docs/tools.md) for tool inputs, output shapes, mutation\nbehavior, and common errors.\n\n## Configuration\n\nEnvironment variables and env files are the preferred configuration paths for\nMCP clients, containers, and other launchers that inject secrets:\n\n```bash\nexport ABS_BASE_URL=http://localhost:13388\nexport ABS_API_KEY=...\nexport ABS_READ_ONLY=true\nexport ABS_TIMEOUT=30s\nexport ABS_FIXTURE_DIR=test/abs\nexport ABS_EXTRA_HEADERS_FILE=/path/to/headers.json\nexport ABS_TLS_CA_CERT_FILE=/path/to/corporate-ca.pem\nexport ABS_TLS_INSECURE_SKIP_VERIFY=false\n```\n\nThe server can load those same values from a Docker-style env file:\n\n```bash\ngo run ./cmd/abs-mcp --env-file /path/to/.env\n```\n\nThe server also accepts matching Cobra/Viper CLI flags. Precedence is explicit\nCLI flags, then process environment variables, then `--env-file`, then built-in\ndefaults:\n\n```bash\ngo run ./cmd/abs-mcp \\\n  --env-file /path/to/.env \\\n  --base-url http://localhost:13388 \\\n  --api-key ... \\\n  --read-only=true \\\n  --timeout 30s \\\n  --fixture-dir test/abs \\\n  --extra-headers-file /path/to/headers.json \\\n  --header 'CF-Access-Client-Id=...' \\\n  --header 'CF-Access-Client-Secret=...' \\\n  --tls-ca-cert-file /path/to/corporate-ca.pem\n```\n\nPrefer `ABS_API_KEY` over `--api-key` outside short local debugging sessions so\ntokens do not land in shell history or process listings.\n\n| Environment variable | CLI flag | Default |\n| --- | --- | --- |\n| n/a | `--env-file` | unset |\n| `ABS_BASE_URL` | `--base-url` | required |\n| `ABS_API_KEY` | `--api-key` | required |\n| `ABS_READ_ONLY` | `--read-only` | `true` |\n| `ABS_TIMEOUT` | `--timeout` | `30s` |\n| `ABS_FIXTURE_DIR` | `--fixture-dir` | `test/abs` |\n| `ABS_EXTRA_HEADERS_FILE` | `--extra-headers-file` | unset |\n| n/a | `--header NAME=VALUE` | unset |\n| `ABS_TLS_CA_CERT_FILE` | `--tls-ca-cert-file` | unset |\n| `ABS_TLS_INSECURE_SKIP_VERIFY` | `--tls-insecure-skip-verify` | `false` |\n\n`ABS_EXTRA_HEADERS_FILE` is optional. When set, it must point to a JSON object\nof string header names to string values, for example\n`{\"X-Corp-Trace\":\"trace-1\"}`. `Authorization` is rejected there; use\n`ABS_API_KEY` for Audiobookshelf authentication.\n\n`--env-file` supports simple Docker-style dotenv lines such as `KEY=value`,\n`KEY=\"value\"`, `KEY='value'`, blank lines, comments, and optional `export`\nprefixes. Unknown keys are ignored by the MCP server.\n\nUse `--header NAME=VALUE` for quick local header injection. It is repeatable,\nand duplicate names override values from `ABS_EXTRA_HEADERS_FILE`. Prefer the\nfile for secrets such as Cloudflare Access credentials because CLI flags can\nshow up in shell history and process listings.\n\nFor private or corporate TLS certificates, prefer `ABS_TLS_CA_CERT_FILE` or\n`--tls-ca-cert-file` with a PEM CA bundle. Use\n`ABS_TLS_INSECURE_SKIP_VERIFY=true` or `--tls-insecure-skip-verify` only as a\ntemporary fallback while fixing local trust.\n\n## Safety\n\n`abs-mcp` defaults to read-only mode. With `ABS_READ_ONLY=true`, all mutating\ntools are blocked before making Audiobookshelf API calls.\n\nThese tools can mutate Audiobookshelf state and require `ABS_READ_ONLY=false`:\n\n- `abs_scan_library`\n- `abs_scan_library_and_wait`\n- `abs_scan_item`\n- `abs_update_item_cover`\n- `abs_remove_item_cover`\n- `abs_update_item_chapters`\n- `abs_update_item_metadata` (planned; not implemented)\n- `abs_match_item` (planned; not implemented)\n- `abs_update_item_tracks`\n- `abs_create_collection`\n- `abs_update_collection`\n- `abs_delete_collection`\n- `abs_add_collection_item`\n- `abs_remove_collection_item`\n- `abs_create_playlist`\n- `abs_update_playlist`\n- `abs_delete_playlist`\n- `abs_add_playlist_item`\n- `abs_remove_playlist_item`\n- `abs_remove_library_items_with_issues`\n\nThe newly advertised item, collection, and playlist mutation tools are stubs:\nthey validate read-only mode and destructive confirmations, then return a clear\nnot-implemented error until their Audiobookshelf source and Docker fixture\nbehavior are verified.\n\n`abs_remove_library_items_with_issues` also requires the exact confirmation\nstring `remove issues from \u003clibraryId\u003e` and can check an expected issue count\nbefore it asks Audiobookshelf to remove missing or invalid items.\n\nFuture destructive tools should follow the same pattern: `ABS_READ_ONLY=false`\nmust be necessary but not sufficient, and the tool should require an explicit\nconfirmation input before deleting, removing, purging, replacing, overwriting,\nor broadly batch-mutating Audiobookshelf data.\n\nThe server requires an Audiobookshelf base URL and API key or bearer token.\nPrefer an Audiobookshelf API key with the least permissions needed for the\ntools you plan to expose. Bearer tokens, API keys, raw `Authorization` headers,\nand extra header values are not logged by this server. `Authorization` is\nrejected in `ABS_EXTRA_HEADERS_FILE`; use `ABS_API_KEY` for Audiobookshelf\nauthentication.\n\n## Installation\n\nDownload a release archive from the\n[GitHub releases page](https://github.com/jeeftor/abs-mcp/releases), unpack it,\nand point your MCP client at the `abs-mcp` binary. The server speaks MCP over\nstdio.\n\nFor local development, you can also run the server from source:\n\n```bash\ngo run ./cmd/abs-mcp\n```\n\n### Client Configs\n\nClaude Desktop, Cursor, VS Code, and Windsurf all support stdio MCP servers\nwith a command, arguments, and environment values. Use an absolute binary path\nand prefer `env` or `--env-file` for secrets.\n\nClaude Desktop `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"Audiobookshelf\": {\n      \"command\": \"/path/to/abs-mcp\",\n      \"args\": [\n        \"--env-file\",\n        \"/path/to/abs-mcp.env\",\n        \"--extra-headers-file\",\n        \"/path/to/cf-headers.json\"\n      ]\n    }\n  }\n}\n```\n\nClaude Code:\n\n```bash\nclaude mcp add Audiobookshelf /path/to/abs-mcp \\\n  -e ABS_BASE_URL=http://localhost:13378 \\\n  -e ABS_API_KEY=... \\\n  -e ABS_READ_ONLY=true\n```\n\nCursor `mcp.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"Audiobookshelf\": {\n      \"command\": \"/path/to/abs-mcp\",\n      \"env\": {\n        \"ABS_BASE_URL\": \"http://localhost:13378\",\n        \"ABS_API_KEY\": \"...\",\n        \"ABS_READ_ONLY\": \"true\"\n      }\n    }\n  }\n}\n```\n\nVS Code MCP config:\n\n```json\n{\n  \"servers\": {\n    \"Audiobookshelf\": {\n      \"type\": \"stdio\",\n      \"command\": \"/path/to/abs-mcp\",\n      \"env\": {\n        \"ABS_BASE_URL\": \"http://localhost:13378\",\n        \"ABS_API_KEY\": \"...\",\n        \"ABS_READ_ONLY\": \"true\"\n      }\n    }\n  }\n}\n```\n\nWindsurf MCP config using an env file:\n\n```json\n{\n  \"mcpServers\": {\n    \"Audiobookshelf\": {\n      \"command\": \"/path/to/abs-mcp\",\n      \"args\": [\n        \"--env-file\",\n        \"/path/to/abs-mcp.env\"\n      ]\n    }\n  }\n}\n```\n\nDocker-based stdio config:\n\n```json\n{\n  \"mcpServers\": {\n    \"Audiobookshelf\": {\n      \"command\": \"docker\",\n      \"args\": [\n        \"run\",\n        \"--rm\",\n        \"-i\",\n        \"-e\",\n        \"ABS_BASE_URL=http://host.docker.internal:13378\",\n        \"-e\",\n        \"ABS_API_KEY\",\n        \"-e\",\n        \"ABS_READ_ONLY=true\",\n        \"ghcr.io/jeeftor/abs-mcp:0.1.1\"\n      ],\n      \"env\": {\n        \"ABS_API_KEY\": \"...\"\n      }\n    }\n  }\n}\n```\n\nRun the container image directly:\n\n```bash\ndocker run --rm -i \\\n  -e ABS_BASE_URL=http://host.docker.internal:13388 \\\n  -e ABS_API_KEY=... \\\n  -e ABS_READ_ONLY=true \\\n  ghcr.io/jeeftor/abs-mcp:0.1.1\n```\n\nWith Cloudflare Access headers and a corporate/private CA bundle:\n\n```bash\ndocker run --rm -i \\\n  -e ABS_BASE_URL=https://abs.example.com \\\n  -e ABS_API_KEY=... \\\n  -e ABS_EXTRA_HEADERS_FILE=/run/secrets/abs-headers.json \\\n  -e ABS_TLS_CA_CERT_FILE=/run/secrets/corporate-ca.pem \\\n  -v /path/to/headers.json:/run/secrets/abs-headers.json:ro \\\n  -v /path/to/corporate-ca.pem:/run/secrets/corporate-ca.pem:ro \\\n  ghcr.io/jeeftor/abs-mcp:0.1.1\n```\n\nBuild a local image:\n\n```bash\nmake docker-build\n```\n\n## Local Development\n\nBring up the repo-local Audiobookshelf fixture, scan the staged test media,\nbuild the MCP server, and write a local MCP client config:\n\n```bash\nmake dev\n```\n\nThat target leaves Audiobookshelf running on `http://localhost:13388` and writes\n`.mcp.dev.json`. The generated config points at `bin/abs-mcp`, includes the\nfixture token from `test/abs/.env.testing`, sets `ABS_READ_ONLY=true`, and is\ngitignored.\n\nUse this command when you need mutating scan tools enabled in a local client:\n\n```bash\nmake mcp-dev-config-read-write\n```\n\nStop the fixture when done:\n\n```bash\nmake abs-dev-down\n```\n\nInstall the local pre-commit hooks:\n\n```bash\nprek install\nprek install --hook-type commit-msg\n```\n\nRun all hooks manually:\n\n```bash\nprek run --all-files\n```\n\n## Tests\n\nRun unit and protocol tests:\n\n```bash\nmake test-unit\n```\n\nRun Docker-backed Audiobookshelf integration tests:\n\n```bash\nmake abs-test-integration\n```\n\nThe integration target resets and scans the repo-local ABS fixture before\nrunning tests.\n\nStop fixture containers when done:\n\n```bash\nmake abs-dev-down\n```\n\n## CI and Releases\n\nGitHub Actions runs unit tests, Go package tests, a binary build, and a Docker\nimage build on pushes and pull requests to `master`.\n\nTags matching `v*` publish release archives for Linux, macOS, and Windows on\namd64 and arm64. The release workflow also publishes a multi-arch Docker image\nto `ghcr.io/jeeftor/abs-mcp`.\n\n## MCP Registry\n\nThis repository is prepared for the official MCP Registry using the OCI package\npath:\n\n- Registry name: `io.github.jeeftor/abs-mcp`\n- Package: `ghcr.io/jeeftor/abs-mcp:\u003cversion\u003e`\n- Transport: `stdio`\n- Metadata file: `server.json`\n\nThe Docker image includes the required MCP ownership label\n`io.modelcontextprotocol.server.name=io.github.jeeftor/abs-mcp`.\n\nOn `v*` tags, the release workflow builds the immutable GHCR image tag, rewrites\n`server.json` to the tag version, authenticates to the MCP Registry with GitHub\nOIDC, and publishes with `mcp-publisher`. GitHub OIDC does not require a\ndedicated registry secret.\n\nAfter the official registry entry is published, downstream aggregators can pick\nit up from the registry API. Glama is the next practical listing target.\nSmithery should wait until this project either ships an MCPB bundle for stdio\ndistribution or adds a public Streamable HTTP transport with appropriate auth.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjeeftor%2Fabs-mcp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjeeftor%2Fabs-mcp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjeeftor%2Fabs-mcp/lists"}