annas-mcp

🚀 Anna's Archive MCP 服务器（及命令行工具）

这是一个基于 Model Context Protocol（MCP）服务器 的命令行工具，可用于从 Anna's Archive 搜索和下载文档。

⚠️ 重要提示

尽管公众对 Anna's Archive 存在不同看法，但该平台主要是一个用于自动检索采用宽松许可框架发布的文档的综合资源库，其中包括采用知识共享许可协议发布的作品和公共领域的资料。本软件不支持未经授权获取受版权保护的内容，仅作为一种工具使用。请用户尊重作者的知识产权，并认识到创作这些文档所付出的巨大努力。

🚀 快速开始

✨ 可用操作

| 操作 | MCP 工具 | 命令行命令 | | ---- | ---- | ---- | | 根据指定条件在 Anna's Archive 中搜索文档 | search | search | | 下载之前通过 search 工具找到的特定文档 | download | download |

📦 安装指南

仅使用命令行工具

若你仅打算使用命令行工具，需要完成以下准备：

• 向 Anna's Archive 捐赠，以获得 JSON API 访问权限。
• 获取 API 密钥。

作为 MCP 服务器使用

若你打算将此项目作为 MCP 服务器使用，除上述要求外，还需要一个 MCP 客户端，例如 Claude Desktop。

同时，你的环境中需要设置以下两个变量：

• ANNAS_SECRET_KEY：API 密钥
• ANNAS_DOWNLOAD_PATH：文档下载路径

🔧 环境搭建

从 GitHub 发布页面 下载合适的二进制文件。

如果你想将该工具作为 MCP 服务器使用，需要将其集成到你的 MCP 客户端中。以 Claude Desktop 为例，可参考以下配置示例：

"anna-mcp": {
    "command": "/Users/iosifache/Downloads/annas-mcp",
    "args": ["mcp"],
    "env": {
        "ANNAS_SECRET_KEY": "feedfacecafebeef",
        "ANNAS_DOWNLOAD_PATH": "/Users/iosifache/Downloads"
    }
}

💻 使用示例

作为 MCP 服务器使用

暂未提供相关示例代码，若有可进一步补充。

作为命令行工具使用

暂未提供相关示例代码，若有可进一步补充。