MCP Wcpl

威克县公共图书馆MCP服务器

一种模型上下文协议（MCP）服务器，为威克县公共图书馆目录提供搜索功能。

使用官方MCP Python SDK和uv进行依赖管理，使用Python构建。

特性

• 搜索威克县公共图书馆目录
• 搜索当地威克县目录或所有北卡罗来纳州Cardinal图书馆
• 返回详细信息，包括：

- 标题 - 作者 - 格式（书籍、DVD、有声读物等） - 出版年份 - 可用性状态 - 直接链接到目录条目 - 封面图片

先决条件

• Python 3.12或更高版本
• 紫外线 -快速Python包管理器

安装uv

# macOS and Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

# Windows
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

# Or with pip
pip install uv

安装

# Clone the repository
git clone 
cd mcp-wcpl

# Install dependencies
uv sync

用法

使用克劳德桌面

将此添加到您的Claude Desktop配置文件中：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

视窗: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "wake-county-library": {
      "command": "uv",
      "args": [
        "--directory",
        "/absolute/path/to/mcp-wcpl",
        "run",
        "python",
        "-m",
        "mcp_wcpl"
      ]
    }
  }
}

替换 /absolute/path/to/mcp-wcpl 带有此项目目录的实际路径。

直接运行

您也可以直接运行服务器进行测试：

# Using uv (recommended)
uv run python -m mcp_wcpl

# Or activate the virtual environment first
source .venv/bin/activate  # Unix/macOS
.venv\Scripts\activate     # Windows
python -m mcp_wcpl

可用工具

search_library

搜索威克县公共图书馆目录。

参数：

• query （字符串，必填）：搜索词（书名、作者、关键字等）
• searchSource （字符串，可选）：

- "local" （默认）-仅搜索威克县目录 - "all" -搜索所有NC Cardinal库

• limit （number，可选）：返回的最大结果数（默认值：10）

例子：

{
  "query": "Foundation Isaac Asimov",
  "searchSource": "local",
  "limit": 5
}

答复：

返回具有以下结构的搜索结果数组：

[
  {
    "title": "Foundation",
    "author": "Asimov, Isaac",
    "format": "Book",
    "publicationYear": "2004",
    "availability": "Available",
    "url": "https://catalog.wake.gov/Union/Record/...",
    "coverImage": "https://..."
  }
]

发展

测试

运行测试套件：

# Run all tests
uv run pytest

# Run with verbose output
uv run pytest -v

# Run with coverage report
uv run pytest --cov=src/mcp_wcpl --cov-report=html

# Run specific test file
uv run pytest tests/test_server.py

测试套件将包括：

• HTML解析逻辑的单元测试
• 使用模拟HTTP请求进行搜索功能的集成测试
• MCP服务器工具接口测试
• 错误处理测试

添加依赖关系

# Add a runtime dependency
uv add 

# Add a development dependency
uv add --dev 

项目结构

mcp-wcpl/
├── src/
│   └── mcp_wcpl/             # Main package
│       ├── __init__.py       # Package initialization
│       ├── __main__.py       # Entry point
│       └── server.py         # MCP server implementation
├── tests/                    # Test files
│   ├── __init__.py
│   └── test_server.py
├── .venv/                    # Virtual environment (created by uv)
├── pyproject.toml            # Project configuration
├── uv.lock                   # Dependency lock file
├── .gitignore
├── README.md
└── CLAUDE.md                 # Instructions for Claude Code

运作原理

服务器将：

1. 为威克县图书馆目录构建搜索URL
2. 使用带有适当HTTP标头的httpx获取搜索结果
3. 使用BeautifulSoup4解析HTML响应
4. 从结果中提取相关书籍信息
5. 通过MCP协议返回结构化JSON数据

许可证

麻省理工学院

链接

• 威克县公共图书馆
• 图书馆目录
• 模型上下文协议