ragflow-mcp-server-fixed

Un servidor RAGFlow MCP corregido para clientes MCP stdio.

Mantiene el nombre del ejecutable ragflow-mcp-server, por lo que los clientes pueden cambiar desde el paquete original simplemente cambiando la fuente del paquete.

Qué corrige esto

Algunas implementaciones de RAGFlow devuelven errores desde el endpoint de chat heredado, por ejemplo:

'NoneType' object is not subscriptable
required argument are missing: messages

Este servidor maneja eso mediante:

llamadas directas a las API HTTP de RAGFlow;
análisis defensivo de las respuestas de flujo (stream);
uso de una alternativa al endpoint de RAGFlow compatible con OpenAI cuando es necesario;
devolución de mensajes de error más claros desde RAGFlow.

Herramientas

Herramienta	Propósito
`list_datasets`	Listar conjuntos de datos de RAGFlow.
`create_chat`	Crear un asistente de chat y una sesión para un conjunto de datos.
`chat`	Hacer una pregunta en una sesión devuelta por `create_chat`.
`ask_configured_chat`	Hacer una pregunta directamente a un asistente de chat de RAGFlow configurado en el servidor.
`retrieve`	Recuperar fragmentos coincidentes directamente de un conjunto de datos.

Para la mayoría de los usos, configure --default-chat-name o --default-chat-id, y luego use ask_configured_chat.

Inicio rápido

{
  "command": "uvx",
  "args": [
    "--from",
    "git+https://github.com/FoundZiGu/ragflow-mcp-server-fixed.git@v0.1.2",
    "ragflow-mcp-server",
    "--api-key",
    "ragflow-REPLACE_WITH_YOUR_KEY",
    "--base-url",
    "http://<RAGFLOW_HOST>:9380",
    "--default-chat-name",
    "<CHAT_NAME>"
  ]
}

Si su cliente MCP admite variables de entorno:

{
  "command": "uvx",
  "args": [
    "--from",
    "git+https://github.com/FoundZiGu/ragflow-mcp-server-fixed.git@v0.1.2",
    "ragflow-mcp-server"
  ],
  "env": {
    "RAGFLOW_API_KEY": "ragflow-REPLACE_WITH_YOUR_KEY",
    "RAGFLOW_BASE_URL": "http://<RAGFLOW_HOST>:9380",
    "RAGFLOW_DEFAULT_CHAT_NAME": "<CHAT_NAME>"
  }
}

Use el ID de chat en lugar del nombre cuando sea posible:

{
  "command": "uvx",
  "args": [
    "--from",
    "git+https://github.com/FoundZiGu/ragflow-mcp-server-fixed.git@v0.1.2",
    "ragflow-mcp-server",
    "--api-key",
    "ragflow-REPLACE_WITH_YOUR_KEY",
    "--base-url",
    "http://<RAGFLOW_HOST>:9380",
    "--default-chat-id",
    "<CHAT_ID>"
  ]
}

Opciones del servidor

Opción	Variable de entorno	Descripción
`--api-key`	`RAGFLOW_API_KEY`	Clave de API de RAGFlow.
`--base-url`	`RAGFLOW_BASE_URL`	URL base de RAGFlow.
`--default-chat-id`	`RAGFLOW_DEFAULT_CHAT_ID`	ID del asistente de chat de RAGFlow existente para `ask_configured_chat`.
`--default-chat-name`	`RAGFLOW_DEFAULT_CHAT_NAME`	Nombre del asistente de chat de RAGFlow existente para `ask_configured_chat`.
`--default-session-name`	`RAGFLOW_DEFAULT_SESSION_NAME`	Nombre de la sesión creada para el chat configurado.

Desarrollo local

uv run ragflow-mcp-server --help

export RAGFLOW_API_KEY="ragflow-REPLACE_WITH_YOUR_KEY"
export RAGFLOW_BASE_URL="http://<RAGFLOW_HOST>:9380"
export RAGFLOW_DEFAULT_CHAT_NAME="<CHAT_NAME>"
uv run python tests/smoke_test.py

Seguridad

No confirme (commit) claves de API.
Prefiera variables de entorno para secretos.
Rote las claves que hayan aparecido en registros, capturas de pantalla, problemas públicos o transcripciones de chat.

Install Server

F

license - not found

B

quality

C

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

–Releases (12mo)

Commit activity

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

ragflow-mcp-server-fixed

ragflow-mcp-server-fixed

Qué corrige esto

Herramientas

Inicio rápido

Opciones del servidor

Desarrollo local

Seguridad

Maintenance

Resources

Looking for Admin?

Tools

Latest Blog Posts

MCP directory API