Indexes local notes and documents with FAISS embeddings and lets agents list knowledge bases and run semantic search over them.
Setup
Choose your client, copy the config, then fill in any required environment variables.
claude mcp add knowledge-base --env HUGGINGFACE_API_KEY='<HUGGINGFACE_API_KEY>' -- npx -y @jeanibarz/knowledge-base-mcp-server@latest~/.codex/config.toml
[mcp_servers.knowledge-base]
command = "npx"
args = ["-y", "@jeanibarz/knowledge-base-mcp-server@latest"]
env = { HUGGINGFACE_API_KEY = "<HUGGINGFACE_API_KEY>" }
# codex mcp add knowledge-base --env HUGGINGFACE_API_KEY='<HUGGINGFACE_API_KEY>' -- npx -y @jeanibarz/knowledge-base-mcp-server@latest~/.cursor/mcp.json
{
"mcpServers": {
"knowledge-base": {
"command": "npx",
"args": [
"-y",
"@jeanibarz/knowledge-base-mcp-server@latest"
],
"env": {
"HUGGINGFACE_API_KEY": "<HUGGINGFACE_API_KEY>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"knowledge-base": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@jeanibarz/knowledge-base-mcp-server@latest"
],
"env": {
"HUGGINGFACE_API_KEY": "<HUGGINGFACE_API_KEY>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"knowledge-base": {
"command": "npx",
"args": [
"-y",
"@jeanibarz/knowledge-base-mcp-server@latest"
],
"env": {
"HUGGINGFACE_API_KEY": "<HUGGINGFACE_API_KEY>"
}
}
}
}claude_desktop_config.json
{
"mcpServers": {
"knowledge-base": {
"command": "npx",
"args": [
"-y",
"@jeanibarz/knowledge-base-mcp-server@latest"
],
"env": {
"HUGGINGFACE_API_KEY": "<HUGGINGFACE_API_KEY>"
}
}
}
}.trae/mcp.json
{
"mcpServers": {
"knowledge-base": {
"command": "npx",
"args": [
"-y",
"@jeanibarz/knowledge-base-mcp-server@latest"
],
"env": {
"HUGGINGFACE_API_KEY": "<HUGGINGFACE_API_KEY>"
}
}
}
}Environment variables
HUGGINGFACE_API_KEY
Replace the placeholders with your own credentials and keep them out of version control.