🍃 후리카케(또는 후리)
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를 사용한 프로세스 상태 관리
- Bun 과 Typescript 로 구축됨
- 밥과 함께 먹으면 좋다
설치(macOS/Linux)
Furikake를 설치하려면 다음 명령을 사용하세요.
지엑스피1
다음을 실행하여 설치를 확인하세요.
Furikake는 Bun을 내부적으로 사용하며, 설치 스크립트는 Bun이 아직 설치되지 않은 경우 자동으로 Bun을 설치합니다.
후리카케 업그레이드
Furikake를 최신 버전으로 업그레이드하려면 다음을 실행하세요.
사용 방법
MCP 관리
Furikake는 다음과 같이 모든 공개 github 저장소에서 작동합니다.
예: furi add smithery-ai/mcp-fetch
rename
명령을 사용하여 MCP의 이름을 바꿀 수도 있습니다. 이 명령을 실행하면 MCP가 다시 시작됩니다.
예: furi rename smithery-ai/mcp-fetch mcp-fetch
MCP 삭제
예: furi가 mcp-fetch를 제거합니다.
설치된 MCP 나열
설치된 모든 MCP 표시
MCP 시작하기
-e env는 선택 사항이며 호출되는 MCP 서버에 따라 달라집니다.
-e
플래그에 유효한 JSON 객체를 전달했는지 확인하세요.
-e
플래그로 서버를 시작하면 설정 파일에 저장되어 서버를 다시 사용할 때 재사용됩니다.
MCP에 필요한 env 변수를 보려면 다음을 사용하세요.
다음을 사용하면 모든 MCP에서 사용 가능한 모든 도구 목록(세부 정보 포함)을 얻을 수 있습니다.
그러면 다음을 사용하여 도구를 호출할 수 있습니다.
도구 호출
매개변수는 작은 따옴표로 묶인 유효한 JSON 문자열이어야 합니다.
MCP 중지
MCP 다시 시작
실행 중인 모든 MCP의 상태를 가져옵니다.
이렇게 하면 실행 중인 모든 MCP의 상태가 표시됩니다.
특정 MCP의 로그를 가져오려면 다음을 사용할 수 있습니다.
더 많은 출력 줄을 보려면 -l <lines>
사용하세요.
구성 저장소
설치된 모든 MCP, 구성 및 로그는 .furikake
디렉토리에 저장되며, 다음을 실행하여 찾을 수 있습니다.
MCP Aggregator 사용
MCP Aggregator를 통해 Cursor 등의 모든 MCP 클라이언트와 함께 Furikake를 사용할 수 있습니다.
Furi는 실행 중인 모든 MCP에서 도구를 수집하여 앱 또는 MCP 클라이언트가 구독할 수 있는 SSE 엔드포인트를 통해 노출합니다. Furi는 실행 중인 모든 MCP에서 도구 목록을 자동으로 작성하고 MCP가 시작되고 중지될 때 새 도구가 추가되는지 확인합니다.
애그리게이터 서버를 시작하려면:
이렇게 하면 MCP 클라이언트가 구독해야 하는 엔드포인트도 표시됩니다.
사용자 정의 포트를 지정할 수 있습니다.
포트를 통과하지 않으면 기본값인 9338로 설정됩니다.
애그리게이터를 중지하려면:
포트 설정을 유지하면서 애그리게이터를 다시 시작하려면:
애그리게이터 서버의 상태를 확인하려면:
더 많은 출력 줄을 보려면 -l <lines>
사용하세요.
HTTP API 사용
- 실행 중인 모든 MCP에는 자동으로 http 경로가 지정됩니다.
- MCP를 켜거나 끄는 작업은 CLI를 통해서만 가능합니다.
http를 통해 MCP에 액세스하려면 다음을 통해 프록시를 켜면 됩니다.
포트를 전달하려면 http start -p <port>
플래그를 사용할 수 있습니다.
포트를 통과하지 않으면 기본값인 9339로 설정됩니다.
경로를 끄려면 다음을 사용할 수 있습니다.
HTTP API 참조
Furikake HTTP API는 공개 경로 와 sudo 경로 로 구분됩니다. 공개 경로는 기본적으로 접근 가능한 반면, sudo 경로는 명시적으로 활성화해야 합니다. sudo 경로를 사용하면 HTTP API를 통해 패키지와 인스턴스를 능동적으로 관리할 수 있습니다.
API 응답 형식
모든 API 엔드포인트는 표준화된 JSON 응답 형식을 따릅니다.
- 성공 응답 :
- 오류 응답 :
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 나열:
모든 온라인 MCP에 사용 가능한 도구를 모두 보려면 다음을 사용하세요.
모든 온라인 MCP에 대한 도구 목록:
특정 MCP에 대한 도구 나열:
도구 호출:
수도 경로
MCP의 API 관리를 허용하는 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의 상태 가져오기:
MCP 설치:
특정 MCP의 상태 및 로그 가져오기:
환경 변수를 사용하여 MCP를 시작합니다.
MCP를 다시 시작합니다.
MCP 중지:
MCP 이름 바꾸기:
MCP 제거:
HTTP API 서버에 문제가 발생하면 furi http status
사용하여 디버깅할 수 있습니다.
마무리 노트
여기까지 읽어주셨다면, Furikake가 유용하고 시간을 절약해 주었기를 바랍니다. MCP를 더 직접 사용해 보고 싶어서 재미 삼아 만들어 봤습니다. 기여하고 싶으시면 이슈나 풀 리퀘스트를 남겨주세요. 변경 사항을 확인한 후 병합하겠습니다.
이것이 좋은 생각이라고 생각하시면, 저장소에 별표를 표시해 주세요.
후리카케를 살펴보셔서 감사합니다.
This server cannot be installed
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 경로가 특징입니다.
Related MCP Servers
- AsecurityFlicenseAqualityMCP 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 -1843TypeScript
- AsecurityFlicenseAqualityMCP 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 -6Python
- -securityFlicense-qualityProvides 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
- -securityAlicense-qualityAn 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 -123TypeScriptMIT License