图书搜索助手

图书馆助理

对话式人工智能助手，帮助用户使用开放图书馆API发现书籍。使用LangChain、Gradio和模型上下文协议（MCP）构建。

特性

• 图书搜索：按标题、作者或关键字搜索书籍
• 作者搜索：寻找作者并探索他们的作品
• 主题浏览：按类型/主题浏览书籍（奇幻、浪漫、神秘等）
• 书籍推荐：根据兴趣获得个性化书籍推荐
• 会话界面：GPT-4o-mini支持的自然语言聊天界面

使用的技术

先决条件

• Python 3.10或更高版本
• 一 开放路由 API密钥

安装

1. 克隆仓库:

   复制

   git clone https://github.com/fernandovbs/library-assistant.git
   cd library-assistant
   

2. 创建虚拟环境 （推荐）：

   复制

   python -m venv venv
   source venv/bin/activate  # On Windows: venv\Scripts\activate
   

3. 安装依赖项:

   复制

   pip install -r requirements.txt
   

4. 配置环境变量:

   复制示例环境文件并添加您的API密钥：

   复制

   cp example.env .env
   

   编辑 .env 并设置您的OpenRouter API密钥：

   复制

   OPENROUTER_API_KEY=your_api_key_here
   OPENROUTER_BASE_URL=https://openrouter.ai/api/v1
   

运行应用程序

该应用程序由两个组件组成，需要在单独的终端中运行：

1.启动MCP服务器

在第一个终端中：

python mcp_server.py

服务器将在以下时间启动 http://localhost:8000 SSE端点位于 http://localhost:8000/sse.

2.启动聊天应用程序

在第二个终端中：

python chat_app_mcp.py

Gradio界面将在浏览器中打开（通常在 http://127.0.0.1:7860).

用法

两台服务器都运行后，您可以通过聊天界面与助手进行交互。尝试以下问题：

• “给我推荐一本好的科幻小说”
• “搜索艾萨克·阿西莫夫的书”
• “给我看看流行的悬疑小说”
• “查找有关人工智能的书籍”
• “什么是顶级奇幻书籍？”

可用工具

MCP服务器公开了以下工具：

项目结构

library-assistant/
├── chat_app_mcp.py    # Gradio chat application with LangChain agent
├── mcp_server.py      # MCP server with Open Library tools
├── requirements.txt   # Python dependencies
├── example.env        # Example environment variables
├── .env               # Your environment variables (not in git)
└── README.md          # This file

配置

环境变量

许可证

该项目使用 开放式库API 对于图书数据。

致谢

• 开放图书馆 提供免费图书数据
• LangChain 用于AI代理框架
• 格拉迪奥 用于聊天界面
• 模型上下文协议 用于工具通信