hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

mcp-flowise

mcp-flowise Flowise API와 통합되는 모델 컨텍스트 프로토콜(MCP) 서버를 구현하는 Python 패키지입니다. 챗플로를 나열하고, 예측을 생성하고, Flowise 챗플로 또는 어시스턴트 도구를 동적으로 등록하는 표준화되고 유연한 방법을 제공합니다.

두 가지 작동 모드를 지원합니다.

LowLevel 모드(기본값) : Flowise API에서 검색된 모든 채팅 흐름에 대한 도구를 동적으로 등록합니다.
FastMCP 모드 : 채팅 흐름을 나열하고 예측을 생성하기 위한 정적 도구를 제공하며, 보다 간단한 구성에 적합합니다.

특징

동적 도구 노출 : LowLevel 모드는 각 채팅 흐름이나 어시스턴트에 대한 도구를 동적으로 생성합니다.
더 간단한 구성 : FastMCP 모드는 최소한의 설정을 위해 list_chatflows 및 create_prediction 도구를 제공합니다.
유연한 필터링 : 두 모드 모두 ID 또는 이름(정규식)을 기준으로 허용 목록 및 차단 목록을 통해 채팅 흐름을 필터링하는 기능을 지원합니다.
MCP 통합 : MCP 워크플로에 완벽하게 통합됩니다.

설치

Smithery를 통해 설치

Smithery를 통해 Claude Desktop에 mcp-flowise를 자동으로 설치하려면:

지엑스피1

필수 조건

Python 3.12 이상
uvx 패키지 관리자

`uvx` 통해 설치 및 실행

uvx 사용하여 GitHub 저장소에서 직접 서버를 실행할 수 있는지 확인하세요.

uvx --from git+https://github.com/matthewhand/mcp-flowise mcp-flowise

MCP 에코시스템 추가( `mcpServers` 구성)

mcpServers 구성에 mcp-flowise 추가하여 MCP 생태계에 통합할 수 있습니다. 예:

{
    "mcpServers": {
        "mcp-flowise": {
            "command": "uvx",
            "args": [
                "--from",
                "git+https://github.com/matthewhand/mcp-flowise",
                "mcp-flowise"
            ],
            "env": {
                "FLOWISE_API_KEY": "${FLOWISE_API_KEY}",
                "FLOWISE_API_ENDPOINT": "${FLOWISE_API_ENDPOINT}"
            }
        }
    }
}

작동 모드

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` )에 대한 구성 예

{
  "mcpServers": {
    "flowise": {
      "command": "C:\\Users\\matth\\.local\\bin\\uvx.exe",
      "args": [
        "--from",
        "C:\\Users\\matth\\downloads\\mcp-flowise",
        "mcp-flowise"
      ],
      "env": {
        "LOGLEVEL": "ERROR",
        "APPDATA": "C:\\Users\\matth\\AppData\\Roaming",
        "FLOWISE_API_KEY": "your-api-key-goes-here",
        "FLOWISE_API_ENDPOINT": "http://localhost:3000/"
      }
    }
  }
}

노트

전체 경로 : uvx.exe 와 복제된 저장소 모두에 대한 전체 경로를 사용하세요.
환경 변수 : 필요한 경우 APPDATA Windows 사용자 프로필(예: C:\\Users\\<username>\\AppData\\Roaming )로 지정합니다.
로그 수준 : 필요에 따라 LOGLEVEL 조정합니다( ERROR , INFO , DEBUG 등).

환경 변수

일반적인

FLOWISE_API_KEY : Flowise API 전달자 토큰( 필수 ).
FLOWISE_API_ENDPOINT : Flowise의 기본 URL(기본값: http://localhost:3000 ).

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 추가합니다.

# .gitignore
.env

문제 해결

API 키가 없습니다 . FLOWISE_API_KEY 올바르게 설정되었는지 확인하세요.
잘못된 구성 : FLOWISE_CHATFLOW_ID 와 FLOWISE_ASSISTANT_ID 모두 설정된 경우 서버가 시작되지 않습니다.
연결 오류 : FLOWISE_API_ENDPOINT 에 도달 가능한지 확인하세요.

특허

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 라이선스 파일을 참조하세요.

할 일

[x] Fastmcp 모드
[x] 저수준 모드
[x] 필터링
[x] Claude 데스크톱 통합
[ ] 보조원

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

Flowise MCP 서버를 사용하면 클라이언트가 채팅 흐름과 통화 예측을 나열하고 DIY Flowise 또는 Flowise Cloud 계정과 원활하게 통합할 수 있습니다. 기존 Flowise 구성에서 채팅 흐름/어시스턴트 예측을 실행할 수 있는 간단한 인터페이스를 제공합니다.

Related Resources

Reddit Discussion about this server

Appeared in Searches

Information about Supabase Platform Features