SYCHEV-LAB-MCP-CLIENT

Sychev Lab MCP Server

Sychev Lab 用の Model Context Protocol（MCP）サーバーです。製品、記事、チュートリアル、Eコマース機能にアクセスできます。

🤖 MCP Server — AI Integration

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 - 自動検出

レガシー 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	ウォッチモードでコンパイルします
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