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 支持。
• 完成项目测试。

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