SYCHEV-LAB-MCP-CLIENT

Sychev Lab MCP Server

Sychev Lab 的 MCP（Model Context Protocol）服务——提供对产品、文章、教程和电子商务功能的访问。

🤖 MCP Server — AI 集成

Claude.ai / Web： 在 Settings → Integrations 中添加：https://lab.sychev.xyz/mcp mcp

Claude Desktop / Cursor：

{
	"mcpServers": {
		"sychev-lab": {
			"command": "npx",
			"args": ["-y", "sychev-lab-mcp-server"]
		}
	}
}

HTTP 端点：

• POST/DELETE /mcp — Streamable HTTP（MCP 2025-06-18 标准）
• GET /.well-known/mcp — 自动发现

特性

• 产品目录：列出、搜索并获取用于 3D 打印的 STL 产品详情
• 文章：访问技术文章和博客文章
• 教程：提供包含难度和时长信息的分步教程
• 类别：按类别浏览产品
• 用户：注册新用户
• 结账：创建 Stripe 支付会话

可用工具

工具	描述
list_products	列出所有可用产品
get_product_details	获取产品的详细信息
search_products_by_category	按类别或关键词搜索产品
get_categories	获取所有可用类别
list_articles	列出所有文章
get_article	获取文章的完整内容
list_tutorials	列出所有教程
get_tutorial	获取教程的完整内容
register_user	注册新用户
create_stripe_checkout	创建 Stripe 结账会话

安装

npm install
npm run build

使用方法

stdio 模式（用于 Claude Desktop）

npm start
# o
node dist/index.js

HTTP 模式（Streamable HTTP）

npm run start:http
# o
PORT=3001 node dist/server-http.js

可用端点：

• POST/DELETE /mcp - Streamable HTTP（MCP 2025-06-18 标准）
• GET /health - 健康检查
• GET /.well-known/mcp - 自动发现

Legacy HTTP 模式

npm run start:http:legacy
# o
node dist/index.js --http 3000

环境变量

变量	描述	默认值
MCP_API_KEY	HTTP 模式的可选 API 密钥	-

配置 Claude Desktop

将以下内容添加到 Claude Desktop 配置文件（claude_desktop_config.json）：

{
	"mcpServers": {
		"sychev-lab": {
			"command": "npx",
			"args": ["-y", "sychev-lab-mcp-server"]
		}
	}
}

或全局安装：

npm install -g sychev-lab-mcp-server

HTTP 端点

以 HTTP 模式运行时（npm run start:http）：

• POST /mcp - Streamable HTTP（MCP 2025-06-18 标准）
• DELETE /mcp - 关闭 Streamable HTTP 会话
• GET /health - 健康检查
• GET /.well-known/mcp - 自动发现

请求头：

Content-Type: application/json
Mcp-Session-Id: <session-id>

脚本

脚本	描述
npm run build	编译 TypeScript
npm run dev	以 watch 模式编译
npm start	启动服务（stdio）
npm run start:http	启动 HTTP 服务
npm run inspector	运行 MCP 检查器
npm run lint	运行 ESLint
npm run typecheck	检查类型但不输出文件

项目结构

src/
├── index.ts       # Punto de entrada MCP (modo stdio)
├── server-http.ts # Servidor MCP con Streamable HTTP
├── tools.ts       # Definiciones e implementaciones de herramientas
├── client.ts      # Cliente HTTP para la API de Sychev Lab
└── config.ts      # Configuración del servidor

许可证

MIT