Accio Servicemeow

Accio ServiceMeow

一个嵌入式案例/票务管理平台 主控程序 服务器，使克劳德等人工智能助手能够通过自然语言创建、更新和分类支持票。

特性

• MCP集成 --16个工具通过Streamable HTTP公开，用于代理AI工作流
• 富文本编辑 --带有代码块、链接和图像的TipTap编辑器
• SLA跟踪 --使用MTTA/MTTR指标按优先级配置目标
• 审计跟踪 --每个票突变都记录有参与者、字段、旧/新值
• 全文检索 --PostgreSQL支持票和笔记的搜索
• 批量操作 --跨多个票证更新状态、分配或优先级
• 基于角色的访问 -具有JWT+neneneba API密钥身份验证的管理员和代理角色
• 自签名TLS --自动生成的证书，支持自定义证书

快速开始

先决条件： 码头工人 和

./setup.sh

这将：

• 创建 .env 从 .env.example （如果不存在）
• 为生成随机秘密 JWT_SECRET, POSTGRES_PASSWORD，以及 DEFAULT_ADMIN_PASSWORD
• 复制 seed.json.example 到 seed.json 用于示例数据
• 构建并启动所有容器
• 等待健康检查并打印您的登录凭据

运行后，打开输出中显示的URL并接受自签名证书警告。

Manual setup

cp .env.example .env
# Edit .env to set your own secrets
docker compose up --build -d

默认凭据： admin / change-me-in-production （从 .env.example)

建筑

Browser ──► nginx (TLS) ──┬──► FastAPI backend ──► PostgreSQL
                          │       ├─ REST API (/api/v1/)
                          │       └─ MCP server (/mcp/)
                          └──► Static frontend (React SPA)

连接克劳德桌面

Claude Desktop仅支持基于stdio的MCP服务器，因此您需要 mcp-proxy 以桥接到HTTP端点。

1. 安装mcp代理：

   pipx install mcp-proxy

1. 创建API密钥 在ServiceMeow UI下 管理>API密钥.

1. 增添 claude_desktop_config.json:

   {
     "mcpServers": {
       "servicemeow": {
         "command": "mcp-proxy",
         "args": [
           "--transport=streamablehttp",
           "--no-verify-ssl",
           "--headers", "api_key", "YOUR_API_KEY",
           "https://localhost:8889/mcp/"
         ]
       }
     }
   }

1. 重新启动克劳德桌面 拿起新服务器。

注： --no-verify-ssl 是自签名证书所必需的。如果使用受信任的TLS证书，请将其删除。

连接克劳德代码

Claude Code通过以下方式连接 mcp-proxy 使用一个 .mcp.json 项目根目录中的文件。

增添 .mcp.json:

{
  "mcpServers": {
    "servicemeow": {
      "command": "mcp-proxy",
      "args": [
        "--transport=streamablehttp",
        "--no-verify-ssl",
        "--headers", "api_key", "YOUR_API_KEY",
        "https://localhost:8889/mcp/"
      ]
    }
  }
}

注： --no-verify-ssl 是自签名证书所必需的。如果使用受信任的TLS证书，请将其删除。

可用的MCP工具

MCP对话示例

创建工单：

“创建一个名为“登录页面超时”的高优先级票证，分配给平台团队，描述用户在登录页面上看到30秒的加载时间。”

分诊入场券：

“显示所有打开的工单。对于未分配给用户的任何关键工单，请将其分配给管理员，并添加一条注释，说明我们正在调查。”

搜索和调查：

“搜索提到‘超时’的工单。显示最新工单的备注和审核日志。”

解决问题：

“解决ASM-0001问题，并附上说明，说明根本原因是缺少数据库索引，该索引已部署到生产环境中。”

环境变量

看 .env.example 对于所有可用配置。

自定义TLS证书

首次启动时会自动生成自签名证书。要使用您自己的：

1. 地方 cert.pem 和 key.pem 在 nginx/certs/
2. 重新启动堆栈： docker compose restart nginx

项目结构

accio-servicemeow/
├── backend/
│   ├── app/
│   │   ├── api/routes/       # FastAPI route handlers
│   │   ├── models/           # SQLAlchemy models
│   │   ├── schemas/          # Pydantic schemas
│   │   ├── services/         # Business logic layer
│   │   ├── mcp/              # MCP server and tool definitions
│   │   └── main.py           # App entrypoint
│   ├── alembic/              # Database migrations
│   ├── tests/                # Pytest test suite
│   └── Dockerfile
├── frontend/
│   ├── src/
│   │   ├── api/              # API client with JWT refresh
│   │   ├── components/       # Shared UI components
│   │   ├── context/          # Auth and Theme providers
│   │   ├── hooks/            # TanStack Query hooks
│   │   ├── pages/            # Route page components
│   │   └── utils/            # Formatting and SLA utilities
│   ├── index.html
│   └── package.json
├── nginx/
│   ├── nginx.conf.template   # Nginx config (envsubst template)
│   ├── Dockerfile
│   └── entrypoint.sh         # TLS cert generation
├── docker-compose.yml
├── seed.json.example          # Sample data for seeding
└── .env.example

运行测试

docker compose exec backend pytest tests/ -v

构建于

• 快速API --异步Python web框架
• SQL炼金术2 --使用asyncpg的异步ORM
• FastMCP --MCP服务器框架
• 反应 + 维特 --前端工具链
• 顺风 CSS --实用程序优先CSS
• TipTap 的 --富文本编辑器
• TanStack查询 --异步数据获取
• PostgreSQL --关系数据库
• 引擎X --带有TLS终止的反向代理