mcp-flowise
mcp-flowise Flowise API와 통합되는 모델 컨텍스트 프로토콜(MCP) 서버를 구현하는 Python 패키지입니다. 챗플로를 나열하고, 예측을 생성하고, Flowise 챗플로 또는 어시스턴트 도구를 동적으로 등록하는 표준화되고 유연한 방법을 제공합니다.
두 가지 작동 모드를 지원합니다.
LowLevel 모드(기본값) : Flowise API에서 검색된 모든 채팅 흐름에 대한 도구를 동적으로 등록합니다.
FastMCP 모드 : 채팅 흐름을 나열하고 예측을 생성하기 위한 정적 도구를 제공하며, 보다 간단한 구성에 적합합니다.
특징
동적 도구 노출 : LowLevel 모드는 각 채팅 흐름이나 어시스턴트에 대한 도구를 동적으로 생성합니다.
더 간단한 구성 : FastMCP 모드는 최소한의 설정을 위해
list_chatflows및create_prediction도구를 제공합니다.유연한 필터링 : 두 모드 모두 ID 또는 이름(정규식)을 기준으로 허용 목록 및 차단 목록을 통해 채팅 흐름을 필터링하는 기능을 지원합니다.
MCP 통합 : MCP 워크플로에 완벽하게 통합됩니다.
Related MCP server: MCP Python Toolbox
설치
Smithery를 통해 설치
Smithery를 통해 Claude Desktop에 mcp-flowise를 자동으로 설치하려면:
지엑스피1
필수 조건
Python 3.12 이상
uvx패키지 관리자
uvx 통해 설치 및 실행
uvx 사용하여 GitHub 저장소에서 직접 서버를 실행할 수 있는지 확인하세요.
MCP 에코시스템 추가( mcpServers 구성)
mcpServers 구성에 mcp-flowise 추가하여 MCP 생태계에 통합할 수 있습니다. 예:
작동 모드
1. FastMCP 모드(간단 모드)
FLOWISE_SIMPLE_MODE=true 로 설정하면 활성화됩니다. 이 모드의 특징은 다음과 같습니다.
list_chatflows와create_prediction두 가지 도구를 공개합니다.FLOWISE_CHATFLOW_ID또는FLOWISE_ASSISTANT_ID사용하여 정적 구성을 허용합니다.list_chatflows통해 사용 가능한 모든 채팅 흐름을 나열합니다.
2. 저수준 모드(FLOWISE_SIMPLE_MODE=False)
특징 :
모든 채팅 흐름을 별도의 도구로 동적으로 등록합니다.
도구의 이름은 채팅 흐름 이름(정규화됨)을 따라 지정됩니다.
FLOWISE_CHATFLOW_DESCRIPTIONS변수의 설명을 사용하고, 설명이 제공되지 않으면 채팅 흐름 이름을 사용합니다.
예 :
my_tool(question: str) -> str채팅 흐름을 위해 동적으로 생성됩니다.
uvx 사용하여 Windows에서 실행
Windows에서 uvx 사용 중이고 --from git+https 옵션 사용 시 문제가 발생하는 경우, 권장되는 해결책은 저장소를 로컬로 복제하고 mcpServers 에 uvx.exe 및 복제된 저장소의 전체 경로를 설정하는 것입니다. 또한 필요에 따라 APPDATA , LOGLEVEL 및 기타 환경 변수를 포함합니다.
MCP 에코시스템(Windows의 mcpServers )에 대한 구성 예
노트
전체 경로 :
uvx.exe와 복제된 저장소 모두에 대한 전체 경로를 사용하세요.환경 변수 : 필요한 경우
APPDATAWindows 사용자 프로필(예:C:\\Users\\<username>\\AppData\\Roaming)로 지정합니다.로그 수준 : 필요에 따라
LOGLEVEL조정합니다(ERROR,INFO,DEBUG등).
환경 변수
일반적인
FLOWISE_API_KEY: Flowise API 전달자 토큰( 필수 ).FLOWISE_API_ENDPOINT: Flowise의 기본 URL(기본값:http://localhost:3010).
LowLevel 모드(기본값)
FLOWISE_CHATFLOW_DESCRIPTIONS:chatflow_id:description쌍을 쉼표로 구분하여 나열한 목록입니다. 예:FLOWISE_CHATFLOW_DESCRIPTIONS="abc123:Chatflow One,xyz789:Chatflow Two"
FastMCP 모드( FLOWISE_SIMPLE_MODE=true )
FLOWISE_CHATFLOW_ID: 단일 Chatflow ID(선택 사항).FLOWISE_ASSISTANT_ID: 단일 어시스턴트 ID(선택 사항).FLOWISE_CHATFLOW_DESCRIPTION: 노출된 단일 도구에 대한 선택적 설명입니다.
채팅 흐름 필터링
다음 환경 변수를 사용하여 두 모드 모두에 필터를 적용할 수 있습니다.
ID별 허용 목록 :
FLOWISE_WHITELIST_ID="id1,id2,id3"ID별 블랙리스트 :
FLOWISE_BLACKLIST_ID="id4,id5"이름으로 화이트리스트 만들기(정규식) :
FLOWISE_WHITELIST_NAME_REGEX=".*important.*"이름으로 블랙리스트 만들기(정규식) :
FLOWISE_BLACKLIST_NAME_REGEX=".*deprecated.*"
참고 : 허용 목록은 차단 목록보다 우선합니다. 둘 다 설정된 경우, 더 제한적인 규칙이 적용됩니다.
보안
API 키 보호 :
FLOWISE_API_KEY가 안전하게 보관되고 로그나 저장소에 노출되지 않도록 하세요.환경 구성 : 민감한 구성에는
.env파일이나 환경 변수를 사용합니다.
.gitignore 에 .env 추가합니다.
문제 해결
API 키가 없습니다 .
FLOWISE_API_KEY올바르게 설정되었는지 확인하세요.잘못된 구성 :
FLOWISE_CHATFLOW_ID와FLOWISE_ASSISTANT_ID모두 설정된 경우 서버가 시작되지 않습니다.연결 오류 :
FLOWISE_API_ENDPOINT에 도달 가능한지 확인하세요.
특허
이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 라이선스 파일을 참조하세요.
할 일
[x] Fastmcp 모드
[x] 저수준 모드
[x] 필터링
[x] Claude 데스크톱 통합
[ ] 보조원