{"name":"annas-mcp: A CLI and MCP Server for Anna's Archive Document Retrieval","description":"annas-mcp is a versatile tool designed as both a CLI utility and an MCP server for interacting with Anna's Archive. It enables users to efficiently search for and download documents from the archive. The project offers flexible deployment options, supporting direct command-line operations or integration with compatible MCP clients.","github":"https://github.com/iosifache/annas-mcp","url":"https://osrepos.com/repo/iosifache-annas-mcp","source":"osrepos.com","sourceDescription":"This repository profile is provided by osrepos.com, an open source repository discovery platform.","repositoryProfile":"https://osrepos.com/repo/iosifache-annas-mcp","generatedFor":"open source discovery and AI-assisted research","markdown":"https://osrepos.com/repo/iosifache-annas-mcp.md","json":"https://osrepos.com/repo/iosifache-annas-mcp.json","topics":["annas-archive","cli","mcp-server","Go","document-retrieval","open-source","utility"],"keywords":["annas-archive","cli","mcp-server","Go","document-retrieval","open-source","utility"],"stars":null,"summary":"annas-mcp is a versatile tool designed as both a CLI utility and an MCP server for interacting with Anna's Archive. It enables users to efficiently search for and download documents from the archive. The project offers flexible deployment options, supporting direct command-line operations or integration with compatible MCP clients.","content":"## Introduction\n\nannas-mcp is an MCP server and CLI tool specifically designed for searching and downloading documents from Anna's Archive. It provides robust functionalities to search for documents based on specified terms and to download specific documents that have been previously identified.\n\nThe project emphasizes responsible use, noting that Anna's Archive serves as a comprehensive repository for automated retrieval of documents released under permissive licensing frameworks, including Creative Commons publications and public domain materials. This software does not endorse unauthorized acquisition of copyrighted content and should be regarded solely as a utility. Users are urged to respect the intellectual property rights of authors.\n\n## Installation\n\nTo get started with annas-mcp, you need to download the appropriate binary for your operating system from the [GitHub Releases section](https://github.com/iosifache/annas-mcp/releases){target=_blank}.\n\nFor CLI usage, you will need a donation to Anna's Archive, which grants JSON API access, and an [API key](https://annas-archive.li/faq#api){target=_blank}. The following environment variables must be set:\n\n*   `ANNAS_SECRET_KEY`: Your Anna's Archive API key.\n*   `ANNAS_DOWNLOAD_PATH`: The path where downloaded documents will be stored.\n\nOptionally, you can set `ANNAS_BASE_URL` to specify a different Anna's Archive mirror, if the default `annas-archive.li` is not working. These variables can also be stored in an `.env` file.\n\nIf you plan to use annas-mcp as an MCP server, you will also need an MCP client, such as [Claude Desktop](https://claude.ai/download){target=_blank}, and configure it to integrate with the annas-mcp binary.\n\n## Examples\n\n### As a CLI Tool\n\nOnce installed and configured, you can use the CLI for searching and downloading:\n\nbash\n# Search Anna's Archive for documents matching 'quantum physics'\nannas-mcp search \"quantum physics\"\n\n# Download a specific document using its ID (obtained from a search)\nannas-mcp download \"document-id-example\"\n\n\n### As an MCP Server\n\nFor integration with an MCP client like Claude Desktop, you would configure it as follows:\n\n\n\"anna-mcp\": {\n    \"command\": \"/Users/iosifache/Downloads/annas-mcp\",\n    \"args\": [\"mcp\"],\n    \"env\": {\n        \"ANNAS_SECRET_KEY\": \"feedfacecafebeef\",\n        \"ANNAS_DOWNLOAD_PATH\": \"/Users/iosifache/Downloads\"\n    }\n}\n\n\nVisual demonstrations are available in the project's GitHub repository, showcasing both CLI and MCP server interactions.\n\n## Why Use It\n\nannas-mcp offers a streamlined and efficient way to interact with Anna's Archive, providing both a direct command-line interface and seamless integration as an MCP server. This dual functionality makes it highly adaptable for various workflows, from automated scripting and batch processing to interactive use with AI clients that support the Model Context Protocol.\n\nIt simplifies the process of finding and retrieving documents, especially for those interested in permissively licensed or public domain content, ensuring quick access to a vast repository of knowledge.\n\n## Links\n\n*   [GitHub Repository](https://github.com/iosifache/annas-mcp){target=_blank}\n*   [Anna's Archive](https://annas-archive.li){target=_blank}\n*   [Model Context Protocol (MCP) Introduction](https://modelcontextprotocol.io/introduction){target=_blank}\n*   [Claude Desktop](https://claude.ai/download){target=_blank}\n*   [The Shadow Library Uptime Monitor](https://open-slum.org){target=_blank}","metrics":{"detailViews":8,"githubClicks":5},"dates":{"published":null,"modified":"2026-02-11T00:00:25.000Z"}}