Dorm Kit – hand-picked gift ideas
Hand-picked gift ideas for moving into a dorm, turned into shareable wishlists fast.
我該用這個嗎
品質與安全性
發現項目(3)
- HIGH
- MEDIUM在 list_marketplaces 中
- INFO在 list_marketplaces 中
根據工具定義與協定合規性的自動化分析。
上下文成本
這是每次將伺服器的工具載入模型上下文時所消耗的約略 token 數量。數量越高,可用於其他工作的注意力就越少。
安裝
一鍵安裝
將以下內容加入你的 `claude_desktop_config.json` 檔案:
{
"mcpServers": {
"dorm-gifts": {
"url": "https://dorm-kit.vercel.app/mcp"
}
}
}遠端端點
https://dorm-kit.vercel.app/mcpstreamable-http它能做什麼
工具清單
工具(7)
⚪health
Service health, storage mode, trackingTag status, and catalog count.
輸入結構描述
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢list_marketplaces
List supported Amazon storefronts (id, domain, defaultLocale). Prefer matching marketplace + locale to the end user. Until real Associates IDs are registered, links omit ?tag= (tagConfigured=false). Never invent placeholders.
輸入結構描述
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢search_kit_items(q, university, dormRules, roomType, budgetBand, ...)
Search dorm / back-to-school essentials. Returns Amazon search deep-links (and optional catalog matches). marketplace + locale are REQUIRED. Until real Associates IDs exist, links omit ?tag= (tagConfigured=false).
輸入結構描述
{
"type": "object",
"properties": {
"q": {
"type": "string",
"minLength": 1,
"description": "Search query, e.g. desk lamp or twin XL sheets"
},
"university": {
"description": "Optional university / campus context",
"type": "string"
},
"dormRules": {
"description": "Residence constraints, e.g. no-candles, no-hot-plates",
"type": "array",
"items": {
"type": "string"
}
},
"roomType": {
"description": "Room type filter",
"type": "string",
"enum": [
"single",
"shared",
"suite",
"studio",
"other"
]
},
"budgetBand": {
"description": "Budget band",
"type": "string",
"enum": [
"under-500",
"500-1500",
"1500-3000",
"3000-plus"
]
},
"marketplace": {
"type": "string",
"minLength": 1,
"description": "Amazon marketplace id (e.g. us, se) or domain (e.g. amazon.com, amazon.se). REQUIRED."
},
"locale": {
"type": "string",
"minLength": 1,
"description": "BCP-47 locale for the shopper (e.g. en-US, sv-SE). REQUIRED."
},
"limit": {
"description": "Max results (1-20)",
"type": "integer",
"minimum": 1,
"maximum": 20
}
},
"required": [
"q",
"marketplace",
"locale"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟡create_kit(studentName, university, dormRules, roomType, budgetBand, ...)
Create an empty or pre-filled dorm kit wishlist. Returns id, editToken, ownerUrl, roommateUrl. marketplace + locale REQUIRED.
輸入結構描述
{
"type": "object",
"properties": {
"studentName": {
"type": "string"
},
"university": {
"type": "string"
},
"dormRules": {
"type": "array",
"items": {
"type": "string"
}
},
"roomType": {
"type": "string",
"enum": [
"single",
"shared",
"suite",
"studio",
"other"
]
},
"budgetBand": {
"type": "string",
"enum": [
"under-500",
"500-1500",
"1500-3000",
"3000-plus"
]
},
"marketplace": {
"type": "string",
"minLength": 1,
"description": "Amazon marketplace id (e.g. us, se) or domain (e.g. amazon.com, amazon.se). REQUIRED."
},
"locale": {
"type": "string",
"minLength": 1,
"description": "BCP-47 locale for the shopper (e.g. en-US, sv-SE). REQUIRED."
},
"items": {
"type": "array",
"items": {
"type": "object",
"properties": {
"title": {
"type": "string"
},
"name": {
"type": "string"
},
"notes": {
"type": "string"
},
"catalogId": {
"type": "string"
},
"asin": {
"type": "string"
},
"url": {
"type": "string"
},
"searchKeywords": {
"type": "string"
},
"emoji": {
"type": "string"
}
}
}
}
},
"required": [
"marketplace",
"locale"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟡create_and_fill_kit(studentName, university, dormRules, roomType, budgetBand, ...)
One-shot: create a dorm kit and fill from itemQueries, itemKeywords, and/or itemAsins. marketplace + locale REQUIRED.
輸入結構描述
{
"type": "object",
"properties": {
"studentName": {
"type": "string"
},
"university": {
"type": "string"
},
"dormRules": {
"type": "array",
"items": {
"type": "string"
}
},
"roomType": {
"type": "string",
"enum": [
"single",
"shared",
"suite",
"studio",
"other"
]
},
"budgetBand": {
"type": "string",
"enum": [
"under-500",
"500-1500",
"1500-3000",
"3000-plus"
]
},
"marketplace": {
"type": "string",
"minLength": 1,
"description": "Amazon marketplace id (e.g. us, se) or domain (e.g. amazon.com, amazon.se). REQUIRED."
},
"locale": {
"type": "string",
"minLength": 1,
"description": "BCP-47 locale for the shopper (e.g. en-US, sv-SE). REQUIRED."
},
"itemAsins": {
"type": "array",
"items": {
"type": "string"
}
},
"itemKeywords": {
"type": "array",
"items": {
"type": "string"
}
},
"itemQueries": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"marketplace",
"locale"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟡add_kit_item(id, editToken, title, name, notes, ...)
Add an item to an existing dorm kit. Requires kit id and editToken from create_kit / create_and_fill_kit.
輸入結構描述
{
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"description": "Wishlist / kit id"
},
"editToken": {
"type": "string",
"minLength": 1,
"description": "Owner edit token (X-Edit-Token)"
},
"title": {
"type": "string"
},
"name": {
"type": "string"
},
"notes": {
"type": "string"
},
"catalogId": {
"type": "string"
},
"asin": {
"type": "string"
},
"url": {
"type": "string"
},
"searchKeywords": {
"type": "string"
},
"emoji": {
"type": "string"
}
},
"required": [
"id",
"editToken"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}⚪resolve_product(asin, keywords, url, budgetBand, category, ...)
Resolve ASIN, Amazon URL, or keywords to a buy deep-link on the selected marketplace. marketplace + locale REQUIRED. amazon.se links include ?tag=sw-dormkit-21 when configured.
輸入結構描述
{
"type": "object",
"properties": {
"asin": {
"type": "string"
},
"keywords": {
"type": "string"
},
"url": {
"type": "string"
},
"budgetBand": {
"type": "string"
},
"category": {
"type": "string"
},
"marketplace": {
"type": "string",
"minLength": 1,
"description": "Amazon marketplace id (e.g. us, se) or domain (e.g. amazon.com, amazon.se). REQUIRED."
},
"locale": {
"type": "string",
"minLength": 1,
"description": "BCP-47 locale for the shopper (e.g. en-US, sv-SE). REQUIRED."
}
},
"required": [
"marketplace",
"locale"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}社群
證據