MCP Grareco

🚀 MCP Grareco

MCP Grareco是一個用於生成圖形記錄的MCP服務器。它藉助MCP協議的強大功能，能夠將任意URL或任意字符串的內容轉換為圖形記錄，為用戶提供便捷的內容圖形化服務。

✨ 主要特性

• 支持多種工具，可實現不同功能，如消息回顯、環境變量顯示、網頁和文本轉換為圖形記錄等。
• 服務器會定期發送隨機級別的日誌消息，方便監控和調試。
• 支持本地運行和在Claude Desktop中使用，使用方式靈活。

📦 安裝指南

在本地運行

# 安裝依賴
npm install

# 項目構建
npm run build

# 以STDIO模式運行
npm run start

# 以SSE模式運行
npm run start:sse

在Claude Desktop中的使用

請在cline_mcp_settings.json中添加以下內容：

示例1

{
  "mcpServers": {
    "grareco": {
      "command": "npx",
      "args": [
        "-y",
        "mcp_grareco"
      ]
    }
  }
}

示例2

{
  "mcpServers": {
    "grareco": {
      "url": "http://localhost:3000/sse",
      "headers": {},
      "timeout": 900
    }
  }
}

💻 使用示例

基礎用法

各工具的使用示例

• echo工具：簡單地回顯輸入消息

# 調用echo工具回顯消息
# 這裡假設通過某種方式調用該工具並傳入message參數
# 例如：工具調用命令 echo --message "Hello, World!"

• printEnv工具：顯示所有環境變量

# 調用printEnv工具顯示環境變量
# 例如：工具調用命令 printEnv

• webToGrareco工具：從URL獲取網頁並將其轉換為圖形記錄格式的HTML

# 調用webToGrareco工具將指定網頁轉換為圖形記錄
# 例如：工具調用命令 webToGrareco --url "https://example.com" --promptType "standard"

• textToGrareco工具：將文本轉換為圖形記錄格式的HTML

# 調用textToGrareco工具將文本轉換為圖形記錄
# 例如：工具調用命令 textToGrareco --text "This is a test text." --promptType "standard"

高級用法

日誌記錄查看

服務器每15秒發送隨機級別的日誌消息，示例如下：

{
  "method": "notifications/message",
  "params": {
    "level": "info",
    "data": "Info-level message"
  }
}

可通過相應的日誌接收和處理機制來監控這些日誌消息，用於調試和監控服務器運行狀態。

📚 詳細文檔

組件 - 工具

1. echo

• 功能：簡單地回顯輸入消息。
• 輸入參數：
  • message (string)：要回顯的消息。
• 返回值：包含回顯消息的文本。

2. printEnv

• 功能：顯示所有環境變量，用於MCP服務器設置的調試。
• 輸入參數：無。
• 返回值：所有環境變量的JSON字符串。

3. webToGrareco

• 功能：從URL獲取網頁並將其轉換為圖形記錄格式的HTML。
• 輸入參數：
  • url (string)：要轉換為目標網頁的URL。
  • promptType (枚舉: "standard" | "elementary" | "timeline", 默認: "standard")：使用的提示類型（標準、小學、時間線）。
• 返回值：生成的HTML文件的保存路徑。
• 注意事項：處理過程中會發送進度通知。

4. textToGrareco

• 功能：將文本轉換為圖形記錄格式的HTML。
• 輸入參數：
  • text (string)：要轉換為目標文本的內容。
  • promptType (枚舉: "standard" | "elementary" | "timeline", 默認: "standard")：使用的提示類型（標準、小學、時間線）。
• 返回值：生成的HTML文件的保存路徑。
• 注意事項：處理過程中會發送進度通知。