PrintVault MCP

打印保险库MCP服务器

专为Claude Desktop、Claude Code和任何兼容MCP的客户端而构建。

______________________________________________________________________

快速开始

先决条件

• 紫外线 （Python包管理器）
• 正在运行的Print Vault实例（v1.1.0+）

安装并运行

# Clone the repo
git clone https://github.com/your-org/PrintVaultMCP.git
cd PrintVaultMCP

# Copy and configure environment
cp .env.example .env
# Edit .env and set PRINT_VAULT_URL to your instance

# Run the server
uv run print-vault-mcp

添加到克劳德桌面

添加到您的 claude_desktop_config.json:

{
  "mcpServers": {
    "print-vault": {
      "command": "uv",
      "args": ["--directory", "/path/to/PrintVaultMCP", "run", "print-vault-mcp"],
      "env": {
        "PRINT_VAULT_URL": "http://192.168.1.100:8000"
      }
    }
  }
}

添加到克劳德代码

claude mcp add print-vault \
  --command "uv --directory /path/to/PrintVaultMCP run print-vault-mcp" \
  --env PRINT_VAULT_URL=http://192.168.1.100:8000

______________________________________________________________________

配置

______________________________________________________________________

工具

40个工具分为7组：

仪表板和系统

库存管理

长丝管理

打印机管理

项目管理

打印跟踪器

参考数据

______________________________________________________________________

项目结构

PrintVaultMCP/
├── src/print_vault_mcp/
│   ├── __init__.py          # Package entry point
│   ├── __main__.py          # python -m support
│   ├── client.py            # Async HTTP client for Print Vault API
│   ├── formatters.py        # AI-friendly response formatters
│   └── server.py            # MCP server & tool definitions
├── docs/
│   ├── design.md            # Architecture & design document
│   └── reference/           # API contract references (links to upstream source)
├── .env.example             # Environment variable template
├── .gitignore
├── pyproject.toml           # uv/pip package configuration
└── README.md

______________________________________________________________________

发展

# Install dependencies
uv sync

# Run the server locally (stdio mode)
PRINT_VAULT_URL=http://localhost:8000 uv run print-vault-mcp

# Run with the MCP inspector for debugging
npx @modelcontextprotocol/inspector uv run print-vault-mcp

______________________________________________________________________

运作原理

服务器是一个无状态协议转换层。它通过MCP（stdio传输）接收来自AI客户端的结构化工具调用，将其转换为针对Print Vault REST API的HTTP请求，并返回AI可以推理的格式化文本响应。

AI Client  ──MCP (stdio)──>  PrintVaultMCP  ──HTTP/JSON──>  Print Vault

打印保险库使用 AllowAny 每个端点（单用户自托管应用程序）的权限，因此MCP服务器只需要基本URL，不需要令牌或凭据。

______________________________________________________________________

许可证