基础MCP数字图书馆

基础MCP数字图书馆是一个基于Model Context Protocol (MCP)的交互式数字图书馆服务,提供图书管理、搜索和书评生成功能。该服务支持图书的添加、搜索和详细信息查看,并能生成专业的书评提示。适用于个人图书管理、文学研究和教育场景。

  • by nadadi
  • 更新于
在 GitHub 查看 nadadi/basic-mcp

使用说明

基本能力

产品定位

基础MCP数字图书馆是一个基于Model Context Protocol (MCP)的交互式数字图书馆服务。

核心功能

  • 🔍 图书搜索: 按标题或作者搜索图书
  • 📖 添加图书: 向图书馆添加新书
  • 📄 详细信息: 获取任何图书的完整信息
  • ✍️ 书评生成: 生成专业书评的提示
  • 💾 内存数据库: 存储完整的图书信息

适用场景

  • 个人图书管理
  • 文学研究
  • 教育场景

工具列表

  1. buscar_libro(termino: str)

    • 按标题或作者搜索图书
    • 示例: buscar_libro("García Márquez")
  2. agregar_libro(titulo: str, autor: str, año: int, genero: str)

    • 向图书馆添加新书
    • 示例: agregar_libro("1984", "George Orwell", 1949, "Distopía")

使用教程

使用依赖

  • Python 3.12+
  • uv (Ultra-fast Python package installer)
  • macOS, Linux 或 Windows

安装教程

  1. 安装uv 在macOS上:
brew install uv
  1. 配置项目
# 克隆或下载项目
cd basic-mcp

# 初始化uv项目 (如果未初始化)
uv init

# 创建虚拟环境
uv venv

# 激活虚拟环境
source .venv/bin/activate

# 安装MCP依赖
uv pip install "mcp[cli]"
  1. 运行服务器
# 开发模式运行
mcp dev server.py

调试方式

  1. 启动服务器: mcp dev server.py
  2. 连接兼容的MCP客户端
  3. 使用工具:
    • 搜索现有图书
    • 添加新书
    • 查询详细信息
    • 生成书评