PromptCraft MCP Server
把 PromptCraft 的公開提示詞庫接到 Claude Code、Cursor 或其他 MCP 用戶端。先選設定範圍，再確認連線狀態。
1. 在目前專案加入
在要使用提示詞庫的專案資料夾執行。local 設定只供你在這個專案使用；公開查詢不需要登入或 API key。
claude mcp add --transport http --scope local promptcraft https://prompt.luvai.net/api/mcp
2. 確認連線
執行檢查指令。Connected 代表 MCP 連線成功；開始 Claude Code 對話後，可在 /mcp 查看工具。
claude mcp get promptcraft
與團隊共用設定
project 設定會寫入專案根目錄的 .mcp.json，可與版本控制一起分享。
claude mcp add --transport http --scope project promptcraft https://prompt.luvai.net/api/mcp
待核准時怎麼做
共用專案設定首次載入可能顯示 Pending approval。請在該專案啟動 claude，檢查並核准這個伺服器，再重新執行檢查指令。這個狀態表示尚未核准，連線檢查還沒開始。
Claude Code 的 .mcp.json 格式
{
"mcpServers": {
"promptcraft": {
"type": "http",
"url": "https://prompt.luvai.net/api/mcp"
}
}
}可用的唯讀工具
list_prompt_tools讀有效工具代碼、公開提示詞數與两語連結；數量按提示詞庫規則，可重疊。query/category/lang/limit 1–25/offset，依next_offset续讀。不是版本或生成能力驗收。
list_model_references讀官方模型參考、核對日期與来源，明示退役/停運/未核實。只讀，不呼叫供應商；query/category/lang/limit 1–25/offset分頁。
search_newsletters字面搜尋已公開電子報標題（不搜HTML內文），完整total，limit 1–25／offset／next_offset分頁。lang只選來源網址介面，原始標題不翻譯。不寄信、不訂閱、不呼叫AI。
get_newsletter直接使用回傳的原始slug，讀完整已公開HTML、日期與真實來源網址。content_format=html，正文不翻譯；不回傳收件人、寄送狀態或私人期數。
search_tutorials查公開教學標題、摘要與 Markdown，query 字面匹配；limit 1–25、offset／next_offset 完整分頁。既有繁中來源，沒有 lang 或 AI 生成。
get_tutorial用回傳 slug 讀完整 Markdown、閱讀分鐘、原始日期與實際來源網址。content_format=markdown，content_language=zh-Hant。
search_keywords查既有公開工程術語，query 字面匹配、category 可分類；limit 1–25、offset／next_offset 分頁。正文繁中，不呼叫 AI、不使用 AI 點數，沒有 lang 參數。
get_keyword用回傳的 slug 讀定義、使用時機、how_to_ask、常見坑、相關詞條與來源連結。只接受 slug，content_language 為 zh-Hant。
list_tags探索公開主題與每個主題的提示詞數。query 搜尋名稱或別名，min_count 為 1–100；limit 為 1–25，offset 從 0 開始，next_offset 為 null 時結束。用回傳的 slug 作為 search_prompts 的 tag。
search_prompts用 tag 精準選擇主題，搭配 query、tool、medium 搜尋；free_only 可限定免費篇，lang 可選 zh 或 en。limit 為 1–25，依 next_offset 續讀。
get_prompt用 slug 讀取公開提示詞。免費篇含全文與變數，PRO 僅含預覽；評分沒有資料時為 null。草稿與排程內容不公開。
list_collections列出公開組合包。lang 可選 zh 或 en；translation_status 說明翻譯狀態，缺少翻譯時保留原文。
get_collection讀取公開組合包的提示詞摘要、編輯註解及連結。limit 為 1–25，依 next_offset 續讀；用 get_prompt 讀單篇內容。
回傳內容
- 免費篇提供 access: full、全文與變數；PRO 篇提供 access: preview，不含全文或變數。
- 提示詞包含評分物件或 null，與公開 REST detail 相同。
- lang 可選 zh 或 en；缺少翻譯時保留原文。
- 工具目錄提供 inputSchema 與 outputSchema；支援的 SDK 可自動驗證 structuredContent。回應也附相同資料的 JSON 文字。
連線疑難排解
- Pending approval：先在該專案啟動 claude 完成核准，再檢查連線。
- 部分用戶端會探測 GET 串流；此端點的 GET 回覆 405 是預期行為。請以 Connected 狀態或成功的 POST 呼叫判斷連線。
- 若連線失敗，先確認 URL、HTTP transport 與目前所在專案的設定範圍。
- 收到 429 時依 Retry-After 秒數再試；上限包含初始化、探索與工具呼叫。
協議與 HTTP 細節
支援 2026-07-28 的逐次請求 metadata，以及 2025-11-25、2025-06-18、2025-03-26 的 initialize 流程。新版先呼叫 server/discover；每次請求附上版本與 clientCapabilities，標頭與內容需一致。
POST /api/mcp
Content-Type: application/json
Accept: application/json, text/event-stream
MCP-Protocol-Version: 2026-07-28
Mcp-Method: server/discover
{
"jsonrpc": "2.0",
"id": "discover-1",
"method": "server/discover",
"params": {
"_meta": {
"io.modelcontextprotocol/protocolVersion": "2026-07-28",
"io.modelcontextprotocol/clientCapabilities": {}
}
}
}tools/call 另附 Mcp-Name，與 params.name 一致。-32022 的 supported 清單可用來選擇版本；-32020 表示標頭與內容不一致。舊版先送 initialize，再送 notifications/initialized，後續附上協商的 MCP-Protocol-Version。
伺服器回覆 JSON，不配置 session ID 或獨立 SSE 串流；GET、DELETE 回覆 405。工具目錄 public 快取期限為 60 秒。請引用回傳的公開網址。
MCP 官方版本規範