ragflow-mcp-server-fixed
ragflow-mcp-server-fixed
stdio MCP 클라이언트를 위한 수정된 RAGFlow MCP 서버입니다.
실행 파일 이름을 ragflow-mcp-server로 유지하므로, 클라이언트는 패키지 소스만 변경하여 기존 패키지에서 전환할 수 있습니다.
수정 사항
일부 RAGFlow 배포 환경에서는 레거시 채팅 엔드포인트에서 오류가 발생합니다. 예:
'NoneType' object is not subscriptable
required argument are missing: messages이 서버는 다음과 같은 방식으로 이를 처리합니다:
RAGFlow HTTP API를 직접 호출합니다.
스트림 응답을 방어적으로 파싱합니다.
필요 시 OpenAI 호환 RAGFlow 엔드포인트로 폴백합니다.
RAGFlow에서 더 명확한 오류 메시지를 반환합니다.
도구
도구 | 목적 |
| RAGFlow 데이터셋을 나열합니다. |
| 데이터셋에 대한 채팅 어시스턴트와 세션을 생성합니다. |
|
|
| 서버에 구성된 RAGFlow 채팅 어시스턴트에게 직접 질문합니다. |
| 데이터셋에서 일치하는 청크를 직접 검색합니다. |
대부분의 사용 사례에서는 --default-chat-name 또는 --default-chat-id를 구성한 다음 ask_configured_chat을 사용하는 것이 좋습니다.
빠른 시작
{
"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>"
]
}MCP 클라이언트가 환경 변수를 지원하는 경우:
{
"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>"
}
}가능하면 이름 대신 채팅 ID를 사용하세요:
{
"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>"
]
}서버 옵션
옵션 | 환경 변수 | 설명 |
|
| RAGFlow API 키. |
|
| RAGFlow 기본 URL. |
|
|
|
|
|
|
|
| 구성된 채팅을 위해 생성된 세션 이름. |
로컬 개발
uv run ragflow-mcp-server --helpexport 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보안
API 키를 커밋하지 마십시오.
보안 정보는 환경 변수를 사용하는 것을 권장합니다.
로그, 스크린샷, 공개 이슈 또는 채팅 기록에 노출된 키는 즉시 교체하십시오.
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/FoundZiGu/ragflow-mcp-server-fixed'
If you have feedback or need assistance with the MCP directory API, please join our Discord server