ds-mcp-flowise 1.1.9 → 1.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 David Soden
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -74,19 +74,55 @@ Instead of manually importing JSON, you can connect directly to your Flowise ins
 
 ### Setup
 
-1. Create a `.env` file in the project root (or in your working directory):
+**Option 1: Inline Configuration (Recommended)**
+
+Add the environment variables directly in your MCP configuration:
+
+**Windows:**
+```json
+{
+  "mcpServers": {
+    "flowise": {
+      "command": "cmd",
+      "args": ["/c", "npx", "-y", "ds-mcp-flowise"],
+      "env": {
+        "FLOWISE_API_URL": "https://your-flowise-instance.com",
+        "FLOWISE_API_KEY": "your-api-key-here"
+      }
+    }
+  }
+}
+```
+
+**Mac / Linux:**
+```json
+{
+  "mcpServers": {
+    "flowise": {
+      "command": "npx",
+      "args": ["-y", "ds-mcp-flowise"],
+      "env": {
+        "FLOWISE_API_URL": "https://your-flowise-instance.com",
+        "FLOWISE_API_KEY": "your-api-key-here"
+      }
+    }
+  }
+}
+```
+
+**Option 2: Environment File**
+
+Create a `.env` file in your working directory:
 
 ```bash
 FLOWISE_API_URL=https://your-flowise-instance.com
 FLOWISE_API_KEY=your-api-key-here
 ```
 
-2. Get your API key from Flowise:
-   - Open your Flowise instance
-   - Go to **Settings** → **API Keys**
-   - Create a new API key or copy an existing one
-
-3. The MCP server will automatically load credentials from `.env` when it starts.
+**Getting your API key:**
+1. Open your Flowise instance
+2. Go to **Settings** → **API Keys**
+3. Create a new API key or copy an existing one
 
 ### Usage
 
@@ -101,8 +137,9 @@ Once configured, you can ask Claude:
 
 ### Security Notes
 
-- Never commit your `.env` file to version control
-- The `.env` file is already in `.gitignore`
+- Never commit API keys to version control
+- If using `.env` files, they're already in `.gitignore`
+- If using inline config, ensure your MCP config file is not shared publicly
 - API keys should be kept private and rotated periodically
 
 ## Alternative Installation Methods
@@ -199,7 +236,7 @@ Then in your MCP config:
 | `validate_flow` | Validate a flow's nodes and connections |
 | `generate_flow_skeleton` | Generate a starting flow for common use cases |
 
-### Flowise API (requires .env configuration)
+### Flowise API (requires API configuration)
 
 | Tool | Description |
 |------|-------------|
@@ -257,6 +294,30 @@ npm run prepare-db
 npm run build
 ```
 
+## Known Issues
+
+All previously reported issues have been fixed in version 1.2.0:
+
+- ✅ `flowise_create_chatflow` now includes `type` parameter (CHATFLOW, AGENTFLOW, MULTIAGENT, ASSISTANT)
+- ✅ Node `baseClasses` are now enriched from marketplace templates
+- ✅ Input classification (inputAnchors vs inputParams) fixed for `asyncOptions` types
+- ✅ Edge and output anchor ID formats now match Flowise conventions
+
+## Troubleshooting
+
+**"Invalid Chatflow Type" error when creating flows**
+- This is a known issue with the `flowise_create_chatflow` tool
+- Workaround: Create a blank chatflow in Flowise UI first, then use `flowise_update_chatflow`
+
+**Connection test fails**
+- Verify your `FLOWISE_API_URL` is correct and accessible
+- Ensure your API key is valid and has the right permissions
+- Check if your Flowise instance requires HTTPS
+
+**Claude doesn't use the flowise tools**
+- Always explicitly mention "flowise tools" or "flowise MCP" in your prompt
+- Example: "**Use the flowise tools** to build me a chatbot"
+
 ## Credits
 
 - [Flowise](https://github.com/FlowiseAI/Flowise) - The no-code LLM orchestration platform

package/data/baseClasses.json

@@ -0,0 +1,340 @@
+{
+  "llmChain": [
+    "LLMChain",
+    "BaseChain",
+    "Runnable"
+  ],
+  "chatPromptTemplate": [
+    "ChatPromptTemplate",
+    "BaseChatPromptTemplate",
+    "BasePromptTemplate",
+    "Runnable"
+  ],
+  "chatOpenAI": [
+    "ChatOpenAI",
+    "BaseChatModel",
+    "BaseLanguageModel",
+    "Runnable"
+  ],
+  "advancedStructuredOutputParser": [
+    "AdvancedStructuredOutputParser",
+    "BaseLLMOutputParser",
+    "Runnable"
+  ],
+  "stickyNote": [
+    "StickyNote"
+  ],
+  "textFile": [
+    "Document"
+  ],
+  "recursiveCharacterTextSplitter": [
+    "RecursiveCharacterTextSplitter",
+    "TextSplitter",
+    "BaseDocumentTransformer",
+    "Runnable"
+  ],
+  "openAIEmbedding_LlamaIndex": [
+    "OpenAIEmbedding",
+    "BaseEmbedding_LlamaIndex",
+    "BaseEmbedding"
+  ],
+  "pineconeLlamaIndex": [
+    "Pinecone",
+    "VectorIndexRetriever"
+  ],
+  "chatOpenAI_LlamaIndex": [
+    "ChatOpenAI",
+    "BaseChatModel_LlamaIndex",
+    "BaseLLM"
+  ],
+  "contextChatEngine": [
+    "ContextChatEngine"
+  ],
+  "RedisBackedChatMemory": [
+    "RedisBackedChatMemory",
+    "BaseChatMemory",
+    "BaseMemory"
+  ],
+  "bufferMemory": [
+    "BufferMemory",
+    "BaseChatMemory",
+    "BaseMemory"
+  ],
+  "conversationChain": [
+    "ConversationChain",
+    "LLMChain",
+    "BaseChain",
+    "Runnable"
+  ],
+  "calculator": [
+    "Calculator",
+    "Tool",
+    "StructuredTool",
+    "BaseLangChain"
+  ],
+  "serpAPI": [
+    "SerpAPI",
+    "Tool",
+    "StructuredTool"
+  ],
+  "conversationalAgent": [
+    "AgentExecutor",
+    "BaseChain",
+    "Runnable"
+  ],
+  "openAIEmbeddings": [
+    "OpenAIEmbeddings",
+    "Embeddings"
+  ],
+  "conversationalRetrievalQAChain": [
+    "ConversationalRetrievalQAChain",
+    "BaseChain",
+    "Runnable"
+  ],
+  "faiss": [
+    "Faiss",
+    "VectorStoreRetriever",
+    "BaseRetriever"
+  ],
+  "documentStore": [
+    "Document"
+  ],
+  "chatMistralAI": [
+    "ChatMistralAI",
+    "BaseChatModel",
+    "BaseLanguageModel",
+    "Runnable"
+  ],
+  "csvAgent": [
+    "AgentExecutor",
+    "BaseChain",
+    "Runnable"
+  ],
+  "markdownTextSplitter": [
+    "MarkdownTextSplitter",
+    "RecursiveCharacterTextSplitter",
+    "TextSplitter",
+    "BaseDocumentTransformer"
+  ],
+  "memoryVectorStore": [
+    "Memory",
+    "VectorStoreRetriever",
+    "BaseRetriever"
+  ],
+  "github": [
+    "Document"
+  ],
+  "promptTemplate": [
+    "PromptTemplate",
+    "BaseStringPromptTemplate",
+    "BasePromptTemplate",
+    "Runnable"
+  ],
+  "huggingFaceInference_LLMs": [
+    "HuggingFaceInference",
+    "LLM",
+    "BaseLLM",
+    "BaseLanguageModel"
+  ],
+  "replicate": [
+    "Replicate",
+    "BaseChatModel",
+    "LLM",
+    "BaseLLM",
+    "BaseLanguageModel",
+    "Runnable"
+  ],
+  "inputModerationSimple": [
+    "Moderation"
+  ],
+  "csvOutputParser": [
+    "CSVListOutputParser",
+    "BaseLLMOutputParser",
+    "Runnable"
+  ],
+  "azureChatOpenAI": [
+    "AzureChatOpenAI",
+    "BaseChatModel",
+    "BaseLanguageModel",
+    "Runnable"
+  ],
+  "localAIEmbeddings": [
+    "LocalAI Embeddings",
+    "Embeddings"
+  ],
+  "chatOllama": [
+    "ChatOllama",
+    "SimpleChatModel",
+    "BaseChatModel",
+    "BaseLanguageModel",
+    "Runnable"
+  ],
+  "pinecone": [
+    "Pinecone",
+    "VectorStoreRetriever",
+    "BaseRetriever"
+  ],
+  "retrieverTool": [
+    "RetrieverTool",
+    "DynamicTool",
+    "Tool",
+    "StructuredTool",
+    "Runnable"
+  ],
+  "toolAgent": [
+    "AgentExecutor",
+    "BaseChain",
+    "Runnable"
+  ],
+  "openAIAssistant": [
+    "OpenAIAssistant"
+  ],
+  "serper": [
+    "Serper",
+    "Tool",
+    "StructuredTool",
+    "Runnable"
+  ],
+  "customTool": [
+    "CustomTool",
+    "Tool",
+    "StructuredTool",
+    "Runnable"
+  ],
+  "chatAnthropic": [
+    "ChatAnthropic",
+    "ChatAnthropicMessages",
+    "BaseChatModel",
+    "BaseLanguageModel",
+    "Runnable"
+  ],
+  "openAPIToolkit": [
+    "OpenAPIToolkit",
+    "Tool"
+  ],
+  "queryEngine": [
+    "QueryEngine",
+    "BaseQueryEngine"
+  ],
+  "compactrefineLlamaIndex": [
+    "CompactRefine",
+    "ResponseSynthesizer"
+  ],
+  "chatAnthropic_LlamaIndex": [
+    "ChatAnthropic",
+    "BaseChatModel_LlamaIndex"
+  ],
+  "googleCustomSearch": [
+    "GoogleCustomSearchAPI",
+    "Tool",
+    "StructuredTool",
+    "Runnable"
+  ],
+  "reactAgentChat": [
+    "AgentExecutor",
+    "BaseChain",
+    "Runnable"
+  ],
+  "simpleChatEngine": [
+    "SimpleChatEngine"
+  ],
+  "azureChatOpenAI_LlamaIndex": [
+    "AzureChatOpenAI",
+    "BaseChatModel_LlamaIndex"
+  ],
+  "sqlDatabaseChain": [
+    "SqlDatabaseChain",
+    "BaseChain",
+    "Runnable"
+  ],
+  "queryEngineToolLlamaIndex": [
+    "QueryEngineTool"
+  ],
+  "subQuestionQueryEngine": [
+    "SubQuestionQueryEngine",
+    "BaseQueryEngine"
+  ],
+  "seqLLMNode": [
+    "LLMNode"
+  ],
+  "seqStart": [
+    "Start"
+  ],
+  "seqConditionAgent": [
+    "ConditionAgent"
+  ],
+  "seqLoop": [
+    "Loop"
+  ],
+  "seqEnd": [
+    "End"
+  ],
+  "seqState": [
+    "State"
+  ],
+  "seqToolNode": [
+    "ToolNode"
+  ],
+  "agentMemory": [
+    "AgentMemory",
+    "BaseCheckpointSaver"
+  ],
+  "seqAgent": [
+    "Agent"
+  ],
+  "supervisor": [
+    "Supervisor"
+  ],
+  "worker": [
+    "Worker"
+  ],
+  "customFunction": [
+    "CustomFunction",
+    "Utilities"
+  ],
+  "seqCondition": [
+    "Condition"
+  ],
+  "startAgentflow": [
+    "Start"
+  ],
+  "conditionAgentAgentflow": [
+    "ConditionAgent"
+  ],
+  "llmAgentflow": [
+    "LLM"
+  ],
+  "retrieverAgentflow": [
+    "Retriever"
+  ],
+  "loopAgentflow": [
+    "Loop"
+  ],
+  "stickyNoteAgentflow": [
+    "StickyNote"
+  ],
+  "agentAgentflow": [
+    "Agent"
+  ],
+  "conditionAgentflow": [
+    "Condition"
+  ],
+  "iterationAgentflow": [
+    "Iteration"
+  ],
+  "directReplyAgentflow": [
+    "DirectReply"
+  ],
+  "humanInputAgentflow": [
+    "HumanInput"
+  ],
+  "toolAgentflow": [
+    "Tool"
+  ],
+  "httpAgentflow": [
+    "HTTP"
+  ],
+  "customFunctionAgentflow": [
+    "CustomFunction"
+  ]
+}