SwiftlyS2 MCP服务器
MCP服务器，为AI代理提供访问 快速S2 文档——CS2（反恐精英2）插件框架。使Claude等人工智能工具在帮助您创建插件时能够搜索、浏览和引用SwiftlyS2 API。
特性
- 6工具 —
search_docs,get_api_reference,list_apis,get_code_examples,get_related_pages,get_cache_status - 资源 --直接URI访问任何文档页面(
swiftlys2://docs/*) - 3提示 --创建插件、调试和学习API的指导工作流程
- 两次运输 --本地stdio用于直接使用，HTTP（流式HTTP）用于远程托管
- 持久磁盘缓存 --重启时立即从保存的文档中加载，每10分钟进行一次智能增量更新
- 自动爬行 swiftlys2.net关于使用内存缓存启动的文档
快速入门（本地）
git clone https://github.com/yourusername/swiftlys2-mcp-server.git
cd swiftlys2-mcp-server
npm install
node src/server-http.js验证： curl http://localhost:3000/health
设置：Coolify部署
- 将此仓库推送到GitHub/GitLab
- 在Coolify仪表板中，单击 +新资源 → 公共仓库
- 粘贴你的Git URL——Coolify自动检测Dockerfile
- 设置您的域名（例如。
swiftlys2-mcp.yourdomain.com) - 点击 部署 --SSL是通过Let’s Encrypt自动实现的
- 验证：
curl https://swiftlys2-mcp.yourdomain.com/health
设置：Docker/Docker Compose
# Docker
docker build -t swiftlys2-mcp .
docker run -d -p 3000:3000 -v swiftlys2-cache:/app/.cache --restart unless-stopped swiftlys2-mcp
# Docker Compose
docker compose up -d设置：本地开发
npm install
# HTTP server (remote clients)
node src/server-http.js
# Stdio server (local MCP clients)
node src/server-stdio.js客户端配置
Claude Code（远程HTTP服务器）
claude mcp add --transport http swiftlys2-docs https://swiftlys2-mcp.yourdomain.com/mcp或本地：
claude mcp add --transport http swiftlys2-docs http://localhost:3000/mcp克劳德代码（本地标准）
claude mcp add swiftlys2-docs -- node /absolute/path/to/swiftlys2-mcp-server/src/server-stdio.js克劳德桌面
添加到您的 claude_desktop_config.json:
远程（流式HTTP）：
{
"mcpServers": {
"swiftlys2-docs": {
"url": "https://swiftlys2-mcp.yourdomain.com/mcp"
}
}
}本地（stdio）：
{
"mcpServers": {
"swiftlys2-docs": {
"command": "node",
"args": ["/absolute/path/to/swiftlys2-mcp-server/src/server-stdio.js"]
}
}
}通用MCP客户端
HTTP服务器公开了一个可流式传输的HTTP端点：
| 方法 | 路径 | 目的 |
|---|---|---|
POST | /mcp | 主请求/响应+可选SSE流 |
GET | /mcp | 服务器发起的通知的SSE流 |
DELETE | /mcp | 会话终止 |
GET | /health | 健康检查({"status":"healthy"}) |
会话通过以下方式跟踪 mcp-session-id 头球
环境变量
| 变量 | 默认值 | 描述 |
|---|---|---|
PORT | 3000 | HTTP服务器端口 |
SWIFTLYS2_CACHE_PATH | .cache/docs-cache.json | 持久磁盘缓存文件的路径 |
SWIFTLYS2_UPDATE_INTERVAL | 600 | 增量更新检查之间的秒数（默认10分钟） |
缓存行为
服务器使用两层缓存策略：
- 内存缓存 --所有页面都存储在内存中，以便快速访问
- 磁盘缓存 --重启后仍能保存的JSON文件
启动流程：
- 从磁盘缓存加载（如果可用）→ 服务器立即可用
- 如果磁盘缓存是新的（\`
缓存在Docker中不持久： 确保您使用的是卷装载 /app/.cache默认情况下，docker-compose.yml包含此内容。
许可证
麻省理工学院