KK Knowledge Agent
kanna12580/kk-knowledge-agent
Base de conhecimento semântica como MCP Server para Agents Claude
Ver no GitHubSistema leve de base de conhecimento com suporte a gerenciamento, upload de textos, busca semântica e integração via MCP Server para Agents. Combina ChromaDB para vetorização com FastAPI para exposição de endpoints, permitindo que ferramentas de IA recuperem informações contextualizadas em tempo real.
Instalação
npx convez-ai kanna12580/kk-knowledge-agent1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Integrar base de conhecimento em Agents e Codex para consultas contextualizadas
- Gerenciar repositórios de documentos com busca semântica em português
- Automatizar recuperação de informações estruturadas via chamadas de MCP Tools
Veredito

Solução prática e bem arquitetada para injetar capacidade de busca semântica em Agents Claude via MCP. Implementação clara em FastAPI + ChromaDB, embora ainda esteja em MVP com dependências que precisam ser validadas para produção (SQLite, sentence-transformers).
README
A tradução para o português deste README ainda está na fila.
kk-knowledge-agent
轻量级知识库 Agent 项目,支持知识库管理、文本/txt 上传、分块向量化、语义检索、流式返回,并通过 MCP Server 暴露给 Agent 调用。
Architecture
Frontend
|
| HTTP
v
Backend API
|
+--> SQLite
+--> ChromaDB
+--> sentence-transformers
Agent / Claude Code / OpenClaw / Hermas Agent
|
| MCP Tool Call
v
MCP Server
|
| HTTP
v
Backend API
Repository Layout
backend/ FastAPI API service
frontend/ React + Vite demo app
mcp-server/ MCP adapter server
examples/ Demo txt documents
AGENTS.md Phased development guide for Codex/Agent
Demo Screenshots
Frontend knowledge base and document workflow:


Codex MCP knowledge base tool call:


Local Setup
Backend
cd backend
python -m venv .venv
.venv\Scripts\activate
pip install -r requirements.txt
copy .env.example .env
uvicorn app.main:app --reload --port 8000
API docs:
http://localhost:8000/docs
Frontend
cd frontend
npm install
npm run dev
Demo app:
http://localhost:5173
MCP Server
cd mcp-server
python -m venv .venv
.venv\Scripts\activate
pip install -r requirements.txt
copy .env.example .env
python server.py
MCP config example:
{
"mcpServers": {
"kk-knowledge": {
"command": "python",
"args": ["mcp-server/server.py"]
}
}
}
MVP Scope
- Knowledge base CRUD with pagination.
- Direct text document upload.
.txtfile upload.- Chunking and local multilingual embedding.
- ChromaDB semantic retrieval.
- SSE streaming search.
- MCP tool:
search_knowledge_base. - Basic tests with pytest.
Development Order
Follow AGENTS.md for the phased implementation plan.
Local Installation
See docs/LOCAL_INSTALLATION.md for detailed Backend, Frontend, and MCP Server setup.
Future Improvements
- Add Docker Compose for one-command local deployment.
- Replace SQLite with PostgreSQL for production usage.
- Replace ChromaDB with Qdrant or Milvus for larger vector workloads.
- Add PDF/DOCX upload.
- Add BM25 + vector hybrid retrieval and rerank support.
- Add answer generation with citation highlights.