Furi

🚀 🍃 Furikake（或 furi）（开发中）

Furikake 是一款易于使用的本地 CLI 和 API 工具，主要用于 MCP 服务器的管理与执行。它能简化 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 支持
• 完成项目测试

以上内容可能随时更新，具体功能和顺序可能会有变动。