Furikake

by ashwwwin

Integrations

  • Built with and supports Bun for running MCP processes

  • Allows downloading MCPs directly from GitHub repositories

  • Supports MCPs built with JavaScript

🍃 Фурикаке (или фури) (НЗП)

Furikake — это простой в использовании локальный CLI и API для управления и выполнения MCP.

  • Загрузите серверы MCP [с GitHub]
  • Обнаружение Smithery.yaml (или автоматическое обнаружение/обработка выполнения)
  • Полнофункциональный CLI [наноспиннеры, читаемость]
  • Поддерживаются встроенные MCP Typescript и Javascript
  • MCP на основе Python являются ключевым элементом дорожной карты (и будут поддерживаться)
  • Маршруты HTTP API (использует Bun http, stdio to http, clear и standard маршруты)
  • Настраиваемый порт и видимость маршрутов sudo
  • Просмотр всех запущенных MCP + журналов для каждого процесса
  • Управление состоянием процесса с помощью PM2
  • Создано с помощью Bun и TypeScript
  • хорошо сочетается с рисом

Установка (macOS/Linux)

Для установки Furikake вы можете использовать следующую команду:

curl -fsSL https://furikake.app/install | bash

Проверьте установку, запустив:

furi

Furikake использует Bun под капотом, скрипт установки установит Bun, если он еще не установлен.

Улучшить Фурикаке

Чтобы обновить Furikake до последней версии, выполните:

furi upgrade

Как использовать

Управление MCP

Furikake работает с любым публичным репозиторием GitHub следующим образом:

furi add <author/repo>

например, фури добавить smithery-ai/mcp-fetch

Вы также можете переименовать MCP, используя команду rename . Обратите внимание, что это приведет к перезапуску MCP, если он запущен.

furi rename <old-name> <new-name>

например, фури переименовать в smithery-ai/mcp-fetch mcp-fetch

Удалить MCP
furi remove <mcpName>

например, фури удалить mcp-fetch

Список установленных MCP

Показать все установленные MCP

furi list
Начать MCP
furi start <mcpName> -e '{"name1":"value1", "name2":"value2"}'

-e env необязателен и зависит от вызываемого сервера MCP

Убедитесь, что вы передаете допустимый объект JSON флагу -e .

После запуска сервера с флагом -e он будет сохранен в файле конфигурации и повторно использован при следующем использовании сервера.

Чтобы просмотреть переменные окружения, необходимые для MCP, используйте:

furi env <mcpName>

Вы можете получить список всех доступных инструментов (с подробностями) любого MCP, используя:

furi tools <mcpName>

то вы можете вызвать инструмент с помощью:

Вызов инструмента
furi call <mcpName> <toolName> '{"param1":"value1", "param2":"value2"}'

Параметры должны быть допустимой строкой JSON, заключенной в одинарные кавычки.

Остановить MCP
furi stop <mcpName>
Перезапустить MCP
furi restart <mcpName>
Получить статус всех работающих MCP

Это покажет вам состояние всех работающих MCP.

furi status

Если вы хотите получить журналы определенного MCP, вы можете использовать:

furi status <mcpName>

чтобы просмотреть больше строк вывода, используйте -l <lines>

Хранилище конфигураций

Все установленные MCP, ваша конфигурация и журналы хранятся в каталоге .furikake , который можно найти, выполнив:

furi where

Использование агрегатора MCP

Вы можете использовать Furikake с любым клиентом MCP, например Cursor, через MCP Aggregator.

Furi собирает инструменты со всех запущенных MCP и предоставляет их через конечную точку SSE, на которую может подписаться ваше приложение или клиент mcp. Агрегатор автоматически создает список инструментов со всех запущенных MCP и прослушивает новые инструменты по мере запуска и остановки MCP.

Для запуска сервера-агрегатора:

furi meta start

Это также покажет вам конечную точку, на которую должен подписаться ваш клиент MCP.

Вы можете указать собственный порт:

furi meta start -p 9338

Если вы не укажете порт, по умолчанию будет 9338.

Чтобы остановить агрегатор:

furi meta stop

Для перезапуска агрегатора (с сохранением настроек порта):

furi meta restart

Чтобы проверить состояние сервера-агрегатора:

furi meta status

Чтобы просмотреть больше строк вывода, используйте -l <lines>

Использование HTTP API

  • Любой работающий MCP автоматически будет иметь http-маршрут.
  • Включение/выключение MCP можно осуществить только через командную строку.

Чтобы получить доступ к вашим MCP через http, вы можете включить прокси-сервер через:

furi http start

Чтобы передать порт, можно использовать флаг http start -p <port> .

furi http start -p 9339

Если вы не укажете порт, по умолчанию будет 9339.

Чтобы отключить маршрут, вы можете использовать:

furi http stop

Справочник по HTTP API

Furikake HTTP API делится на публичные маршруты и маршруты sudo . Публичные маршруты доступны по умолчанию, в то время как маршруты sudo должны быть явно включены. С помощью маршрутов sudo вы можете активно управлять пакетами и экземплярами через HTTP API.

Формат ответа API

Все конечные точки API следуют стандартизированному формату ответа JSON:

  • Успешные ответы :
    { "success": true, "data": {"theResponseVariesByEndpoint"} }
  • Ошибочные ответы :
    { "success": false, "message": "Descriptive error message" }
HTTP-методы
  • POST — используется только для конечных точек /mcpName/call/toolName и /mcpName/start
  • GET — используется для всех остальных конечных точек.

Общественные маршруты

Конечная точкаМетодОписаниеПараметрыФормат ответа
/listПОЛУЧАТЬСписок работающих MCP?all=true (необязательно) для отображения всех установленных MCP{"success": true, "data": ["mcpName1", "mcpName2"]}
/toolsПОЛУЧАТЬПеречислите все доступные инструменты из всех работающих MCPНикто{"success": true, "data": [{"name": "toolName", "description": "Tool description", "inputSchema": {...}, "mcpName": "mcpName"}]}
/<mcpName>/toolsПОЛУЧАТЬСписок инструментов для конкретного MCPНикто{"success": true, "data": [{"name": "toolName", "description": "Tool description", "inputSchema": {...}}]}
/<mcpName>/call/<toolName>ПОЧТАВызов инструмента на MCPПараметры инструмента в формате JSON в теле запроса{"success": true, "data": {/* Tool-specific response */}}
Пример использования:

Список работающих MCP:

curl http://localhost:9339/list

Чтобы просмотреть все доступные инструменты для всех онлайн-MCP, вы можете использовать:

curl "http://localhost:9339/list"

Список инструментов для всех онлайн-MCP:

curl http://localhost:9339/tools

Перечислите инструменты для конкретного MCP:

curl http://localhost:9339/<mcpName>/tools

Вызов инструмента:

curl -X POST http://localhost:9339/<mcpName>/call/<toolName> -d '{"data1":"value1", "data2":"value2"}'

Маршруты Судо

Чтобы включить маршруты sudo, которые позволяют управлять API MCP:

furi http start --sudo
Конечная точкаМетодОписаниеПараметрыФормат ответа
/statusПОЛУЧАТЬПолучить статус всех MCP (работающих и остановленных)Никто{"success": true, "data": [{"name": "mcpName", "pid": "12345", "status": "online", "cpu": "0%", "memory": "10MB", "uptime": "2h"}]}
/add/<author>/<repo>ПОЛУЧАТЬУстановить MCP с GitHubНикто{"success": true, "data": {"installed": true, "message": "Successfully installed"}}
/<mcpName>/statusПОЛУЧАТЬПолучить статус конкретного MCP?lines=10 (необязательно) для управления строками журнала{"success": true, "data": {"name": "mcpName", "pid": "12345", "status": "online", "logs": ["log line 1", "log line 2"]}}
/<mcpName>/restartПОЛУЧАТЬПерезапустить определенный MCPНикто{"success": true, "data": {"restarted": true}}
/<mcpName>/startПОЧТАЗапустить определенный MCPПеременные среды в формате JSON в теле запроса{"success": true, "data": {"started": true}}
/<mcpName>/stopПОЛУЧАТЬОстановка определенного MCPНикто{"success": true, "data": {"stopped": true}}
/<mcpName>/removeПОЛУЧАТЬУдалить определенный MCPНикто{"success": true, "data": {"removed": true}}
Пример использования:

Получить статус всех MCP:

curl http://localhost:9339/status

Установите MCP:

curl http://localhost:9339/add/<author>/<repo>

Получить статус и журналы определенного MCP:

curl "http://localhost:9339/<mcpName>/status?lines=20"

Запустите MCP с переменными среды:

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

Перезапустите MCP:

curl http://localhost:9339/<mcpName>/restart

Остановка MCP:

curl http://localhost:9339/<mcpName>/stop

Удалить MCP:

curl http://localhost:9339/<mcpName>/remove

Если у вас возникли проблемы с сервером HTTP API, вы можете использовать furi http status для отладки.

Заключительные замечания

Если вы дошли до этого места, надеюсь, Furikake окажется для вас полезным и сэкономит время. Я создал его ради развлечения, чтобы поработать с MCP более практической частью. Если вы хотите внести свой вклад, смело открывайте issue или pull request. Я сделаю merge после того, как проверю ваши изменения.

Если вы считаете, что это хорошая идея, пожалуйста, отметьте репозиторий звездочкой.

Спасибо, что заглянули на Furikake.

-
security - not tested
A
license - permissive license
-
quality - not tested

local-only server

The server can only run on the client's local machine because it depends on local resources.

Локальный CLI и API для управления MCP, который позволяет пользователям загружать, устанавливать, управлять и взаимодействовать с MCP из GitHub, включая управление состоянием процесса, распределение портов и маршруты HTTP API.

  1. Установка (macOS/Linux)
    1. Улучшить Фурикаке
  2. Как использовать
    1. Управление MCP
  3. Использование агрегатора MCP
    1. Использование HTTP API
      1. Справочник по HTTP API
      2. Общественные маршруты
      3. Маршруты Судо
    2. Заключительные замечания

      Related MCP Servers

      • A
        security
        A
        license
        A
        quality
        An MCP server to run commands.
        Last updated -
        2
        446
        138
        TypeScript
        MIT License
        • Apple
      • -
        security
        A
        license
        -
        quality
        MCP Server provides a simpler API to interact with the Model Context Protocol by allowing users to define custom tools and services to streamline workflows and processes.
        Last updated -
        13
        2
        TypeScript
        MIT License
      • -
        security
        A
        license
        -
        quality
        A Python-based MCP server that integrates OpenAPI-described REST APIs into MCP workflows, enabling dynamic exposure of API endpoints as MCP tools.
        Last updated -
        2
        39
        Python
        MIT License
        • Linux
        • Apple
      • -
        security
        F
        license
        -
        quality
        An MCP server that provides tools and resources for managing a coding project's todo list, allowing users to view, add, update, and delete todo items with details like priority, status, and tags.
        Last updated -
        1
        Python

      View all related MCP servers

      ID: 0nxvqqr5ln