🚀 书籍MCP服务器项目

本项目 books-mcp-server 提供了一个便捷的服务器环境，可用于特定的业务需求。下面将详细介绍项目的获取、初始化、Python 包安装以及使用 cherry-studio 的示例。

🚀 快速开始

获取项目并初始化

首先，你需要从 GitHub 上克隆项目，并进行初始化操作。以下是具体步骤：

git clone https://github.com/VmLia/books-mcp-server.git
cd books-mcp-server
uv venv

激活虚拟环境

根据不同的操作系统，激活虚拟环境的方式有所不同：

• MacBook 或 Linux：

source .venv/bin/activate

• Windows：

.venv\Scripts\activate.bat

📦 安装指南

安装 Python 包

在激活虚拟环境后，你可以安装所需的 Python 包。以下是基本的安装命令：

uv add "mcp[cli]" httpx openai beautifulsoup4 lxml 

⚠️ 重要提示

如果网络较慢，你可以配置国内镜像源来加速安装过程。使用以下命令：

uv add "mcp[cli]" httpx openai beautifulsoup4 lxml --index-url https://pypi.tuna.tsinghua.edu.cn/simple

💻 使用示例

使用 cherry-studio 的示例

方法 1：通过 cherry-studio 设置页面配置

在 cherry-studio 的设置页面中，点击 MCP 服务器，然后点击“添加服务器”，接着在页面上进行如下配置：

• 类型：

STDIO

• 命令：

uv

• 参数：

--directory
# your project dir
run
main.py

方法 2：使用配置参数

你也可以通过配置参数的方式来使用 cherry-studio。以下是具体的配置示例：

{
  "mcpServers": {
    "books-mcp-server": {
      "name": "books-mcp",
      "type": "stdio", 
      "description": "",
      "isActive": true,
      "registryUrl": "",
      "command": "uv",
      "args": [
        "--directory",
        "/Enter your local project directory/books-mcp-server",
        "run",
        "main.py"
      ]
    }
  }
}