Phrases

🚀 🤖 短語 MCP 服務器

這是一個優雅且高效的短語 MCP 服務器，主要用於管理勵志短語。它專為與桌面版 Claude 以及其他 MCP 客戶端實現無縫集成而精心設計，能為用戶提供便捷的短語管理體驗。

🚀 快速開始

本服務器可輕鬆實現短語管理，還能與桌面版 Claude 集成。以下是快速啟動服務器的步驟：

1. 克隆倉庫：

git clone https://github.com/ronniemh/phrases-MCP-server.git

2. 安裝依賴項：

npm install

3. 啟動服務器：

node index.js

✨ 主要特性

• 完整的短語管理：可輕鬆創建、讀取、更新和刪除短語。
• 與桌面版 Claude 集成：能直接從桌面版 Claude 中對短語進行交互操作。
• 內置 mock API：可使用 mock API 進行測試和開發工作。

🛠️ 可用工具

📦 安裝指南

安裝步驟

1. 克隆倉庫：

git clone https://github.com/ronniemh/phrases-MCP-server.git

2. 安裝依賴項：

npm install

3. 啟動服務器：

node index.js

📚 詳細文檔

與桌面版 Claude 的配置

步驟說明：

1. 複製配置文件：將 config.json 複製到項目根目錄。
2. 編輯配置文件：根據需要修改 API 地址和其他參數。
3. 重啟服務器：完成配置後重啟 MCP 服務。

示例路徑：

Windows：%UserProfile%\.claude\config.json
MacOS 和 Linux：~/.claude/config.json

測試說明

注意事項：

在測試前，請先修改 tsconfig.json 文件中的以下內容：

// 修改此部分以適應測試環境
const BASE_URL = "https://mockapi.io/your-project/user";

項目結構

• src/：包含所有源代碼文件。
• public/：存放公共資產，如圖片和樣式表。
• config.json：項目的配置文件。

開發流程

工作流說明：

1. 編碼階段：
   • 編寫核心功能。
   • 實現與桌面版 Claude 的交互邏輯。
2. 測試階段：
   • 執行單元測試。
   • 確保 API 請求正確無誤。
3. 部署階段：
   • 提交代碼到倉庫。
   • 推送到生產環境。

MockAPI 配置

創建自己的實例：

1. 註冊 MockAPI 賬戶。
2. 創建新項目並添加 user 資源，包含以下字段：
   • id（數字，自動生成）
   • name（字符串）
   • phrase（字符串）
3. 獲取並替換 src/helpers/makeMockAPIRequest.ts 中的 BASE_URL 值。

💻 使用示例

基礎用法

在桌面版 Claude 中，您可以執行以下命令與短語管理器交互：

POST /api/v1/phrases HTTP/1.1
Content-Type: application/json

{
  "phrase": "你的勵志短語"
}

🔧 技術細節

本項目的技術實現涵蓋了短語管理服務器的搭建、與桌面版 Claude 的集成以及 mock API 的使用。通過克隆倉庫、安裝依賴和啟動服務器，可快速搭建開發環境。同時，項目結構清晰，便於開發和維護。

📄 許可證

本項目採用 ISC 許可證。

⚠️ 重要提示

本服務器使用 mock API 存儲數據。在生產環境中，請考慮集成真實數據庫。

💡 使用建議

如遇 MockAPI 相關問題，請檢查免費層的使用限制。項目結構遵循官方 MCP 指南，有助於更好地進行維護。