Skip to main content
Glama

Furikake

by ashwwwin

영상

🍃 후리카케(또는 후리)

Furikake는 MCP 관리 및 실행을 위한 사용하기 쉬운 로컬 CLI 및 API입니다.

  • [GitHub에서] MCP 서버 다운로드
  • Smithery.yaml 감지(또는 실행 자동 감지/처리)
  • 모든 기능을 갖춘 CLI[나노스피너, 가독성]
  • Typescript 및 Javascript MCP가 내장되어 지원됩니다.
  • Python 기반 MCP는 핵심 로드맵 항목이며 지원될 예정입니다.
  • HTTP API 경로(Bun http, stdio to http, clear 및 표준 경로 사용)
  • 사용자 정의 가능한 포트 및 sudo 경로 가시성
  • 실행 중인 모든 MCP + 각 프로세스에 대한 로그 보기
  • PM2를 사용한 프로세스 상태 관리
  • BunTypescript 로 구축됨
  • 밥과 함께 먹으면 좋다

설치(macOS/Linux)

Furikake를 설치하려면 다음 명령을 사용하세요.

지엑스피1

다음을 실행하여 설치를 확인하세요.

furi

Furikake는 Bun을 내부적으로 사용하며, 설치 스크립트는 Bun이 아직 설치되지 않은 경우 자동으로 Bun을 설치합니다.

후리카케 업그레이드

Furikake를 최신 버전으로 업그레이드하려면 다음을 실행하세요.

furi upgrade

사용 방법

MCP 관리

Furikake는 다음과 같이 모든 공개 github 저장소에서 작동합니다.

furi add <author/repo>

예: furi add smithery-ai/mcp-fetch

rename 명령을 사용하여 MCP의 이름을 바꿀 수도 있습니다. 이 명령을 실행하면 MCP가 다시 시작됩니다.

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

예: furi rename smithery-ai/mcp-fetch mcp-fetch

MCP 삭제
furi remove <mcpName>

예: furi가 mcp-fetch를 제거합니다.

설치된 MCP 나열

설치된 모든 MCP 표시

furi list
MCP 시작하기
furi start <mcpName> -e '{"name1":"value1", "name2":"value2"}'

-e env는 선택 사항이며 호출되는 MCP 서버에 따라 달라집니다.

-e 플래그에 유효한 JSON 객체를 전달했는지 확인하세요.

-e 플래그로 서버를 시작하면 설정 파일에 저장되어 서버를 다시 사용할 때 재사용됩니다.

MCP에 필요한 env 변수를 보려면 다음을 사용하세요.

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 Aggregator 사용

MCP Aggregator를 통해 Cursor 등의 모든 MCP 클라이언트와 함께 Furikake를 사용할 수 있습니다.

Furi는 실행 중인 모든 MCP에서 도구를 수집하여 앱 또는 MCP 클라이언트가 구독할 수 있는 SSE 엔드포인트를 통해 노출합니다. Furi는 실행 중인 모든 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를 켜거나 끄는 작업은 CLI를 통해서만 가능합니다.

http를 통해 MCP에 액세스하려면 다음을 통해 프록시를 켜면 됩니다.

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": {"The response varies by endpoint"} }
  • 오류 응답 :
    { "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"}'

수도 경로

MCP의 API 관리를 허용하는 sudo 경로를 활성화하려면:

furi http start --sudo
엔드포인트방법설명매개변수응답 형식
/status얻��모든 MCP의 상태(실행 중 및 중지됨) 가져오기없음{"success": true, "data": [{"name": "mcpName", "pid": "12345", "status": "online", "cpu": "0%", "memory": "10MB", "uptime": "2h"}]}
/add/<author>/<repo>얻다GitHub에서 MCP 설치없음{"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>/rename얻다특정 MCP 이름 바꾸기?newName=<newName> (필수){"success": true, "message": "Renamed from oldName to newName"} 또는 {"success": false, "message": "Error message"}
/<mcpName>/remove얻다특정 MCP 삭제없음{"success": true, "data": {"removed": true}}
/<mcpName>/env얻다특정 MCP에 대한 환경 변수 가져오기없음{"success": true, "data": {"variables": ["key1", "key2"]}}
사용 예:

모든 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>/rename?newName=<newName>"

MCP 제거:

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

HTTP API 서버에 문제가 발생하면 furi http status 사용하여 디버깅할 수 있습니다.

마무리 노트

여기까지 읽어주셨다면, Furikake가 유용하고 시간을 절약해 주었기를 바랍니다. MCP를 더 직접 사용해 보고 싶어서 재미 삼아 만들어 봤습니다. 기여하고 싶으시면 이슈나 풀 리퀘스트를 남겨주세요. 변경 사항을 확인한 후 병합하겠습니다.

이것이 좋은 생각이라고 생각하시면, 저장소에 별표를 표시해 주세요.

후리카케를 살펴보셔서 감사합니다.

-
security - not tested
F
license - not found
-
quality - not tested

local-only server

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

사용자가 GitHub에서 MCP를 다운로드, 설치, 관리하고 상호작용할 수 있도록 하는 MCP 관리를 위한 로컬 CLI 및 API로, 프로세스 상태 관리, 포트 할당, HTTP API 경로가 특징입니다.

  1. 설치(macOS/Linux)
    1. 후리카케 업그레이드
  2. 사용 방법
    1. MCP 관리
  3. MCP Aggregator 사용
    1. HTTP API 사용
      1. HTTP API 참조
      2. 공공 경로
      3. 수도 경로
    2. 마무리 노트

      Related MCP Servers

      • A
        security
        F
        license
        A
        quality
        MCP Server for the GitHub API, providing features for file operations, repository management, and advanced search, with automatic branch creation and comprehensive error handling.
        Last updated -
        18
        4
        3
        TypeScript
        • Linux
        • Apple
      • A
        security
        F
        license
        A
        quality
        MCP server for managing Git operations on local repositories, allowing users to list repositories, get and create tags, list commits, push tags, and refresh repositories through a standardized interface.
        Last updated -
        6
        Python
      • -
        security
        F
        license
        -
        quality
        Provides tools for interacting with GitHub's API through the MCP protocol, allowing users to create repositories, push content, and retrieve user information.
        Last updated -
        JavaScript
      • -
        security
        A
        license
        -
        quality
        An MCP server that wraps around the GitHub CLI tool, allowing AI assistants to interact with GitHub repositories through commands for pull requests, issues, and repository operations.
        Last updated -
        123
        TypeScript
        MIT License
        • Linux
        • Apple

      View all related MCP servers

      MCP directory API

      We provide all the information about MCP servers via our MCP API.

      curl -X GET 'https://glama.ai/api/mcp/v1/servers/ashwwwin/furi'

      If you have feedback or need assistance with the MCP directory API, please join our Discord server