Furi

🚀 🍃 Furikake（或 furi）（開發中）

Furikake 是一款易於使用的本地 CLI 和 API 工具，主要用於 MCP 服務器的管理與執行。它能幫助用戶便捷地從 GitHub 下載 MCP 服務器，具備 Smithery.yaml 檢測等功能，還支持多種編程語言，為 MCP 服務器的管理提供了全面且靈活的解決方案。

🚀 快速開始

Furikake 是一個強大的工具，可用於高效管理 MCP 服務器。以下是使用前的準備步驟和基本操作示例。

✨ 主要特性

• 服務器下載：支持從 GitHub 下載 MCP 服務器，提供 [示例鏈接] 方便操作。
• 配置檢測：具備 Smithery.yaml 檢測功能，可自動檢測/處理執行。
• 全功能 CLI：使用納米 - spinner，提升命令行界面的可讀性。
• 多語言支持：支持 TypeScript 和 JavaScript 的 MCP，Python 基於的 MCP 支持也即將上線。
• HTTP API 路由：採用 Bun http，將 stdio 轉換為 http，提供清晰且標準的路由。
• 靈活配置：可靈活配置端口和 sudo 路由可見性。
• 進程管理：能查看所有運行中的 MCP 以及每個進程的日誌，使用 PM2 進行進程狀態管理。
• 技術構建：基於 Bun 和 TypeScript 構建。
• 趣味特性：和大米很合得來😜

📦 安裝指南

macOS/Linux 系統安裝

首先，安裝 Bun（若尚未安裝）：

curl -fsSL https://bun.sh/install | bash

然後，安裝 Furikake：

curl -fsSL https://furikake.github.io/install.sh | bash

安裝完成後，輸入 furi --version 檢查是否安裝成功。

💻 使用示例

安裝 MCP 服務器

要從 GitHub 安裝 MCP 服務器，請執行以下命令：

furi add username/repository

例如，安裝 [example - repo](https://github.com/username/example - repo)：

furi add username/example - repo

啟動和停止 MCP 服務器

要啟動 MCP 服務器，請運行：

furi start mcpName

要停止 MCP 服務器，請運行：

furi stop mcpName

查看 MCP 狀態

要查看所有運行中的 MCP 服務器狀態，請運行：

furi status

要查看特定 MCP 服務器的狀態，請運行：

furi status mcpName

📚 詳細文檔

HTTP API 文檔

基本使用

啟動 Furikake 的 HTTP 服務器：

furi http start

默認情況下，HTTP 服務將在 localhost:9339 上可用。

公共路由

• / - 顯示所有可用路由
• /health - 檢查服務健康狀態
• /metrics - 提供性能指標（如果啟用）

MCP 管理路由

要使用 sudo 路由，請啟動 HTTP 服務器時添加 --sudo 標誌：

furi http start --sudo

安裝 MCP

通過 POST 請求安裝新的 MCP：

curl -X POST http://localhost:9339/add/username/repository

啟動 MCP

通過 POST 請求啟動 MCP 並設置環境變量：

curl -X POST http://localhost:9339/mcpName/start -d '{"API_KEY":"your - api - key"}'

停止 MCP

通過 POST 請求停止 MCP：

curl -X POST http://localhost:9339/mcpName/stop

🔧 技術細節

問題排查

如果遇到任何問題，請檢查以下內容：

1. 確保 Furikake 已正確安裝。
2. 確保 HTTP 服務器已成功啟動且沒有錯誤日誌。
3. 使用 furi http status 檢查 HTTP 服務狀態。

開發路線圖

• 支持不同 Node.js 版本，根據 package.json 配置通過 nvm 傳遞。
• 添加 Python MCP 支持。
• 完成項目測試。

需注意，以上內容可能隨時更新，具體功能和順序可能會有變動。