worklab-tools
MCP server for personal knowledge management providing AI-powered tools for semantic search, audio transcription, image generation, and PPT creation.
Warning. Serious findings were identified. Review the full report before connecting. Grades reflect the full trust pyramid: code, verification depth, and reputation. New projects cap at C until adoption is earned.
How we verified
Verified is a snapshot. Live keeps it current, and builds your track record.
⚡ Connect GitHub → continuous verification on every pushwhy connect →Who stands behind it
Ryeliu
Source: Glama
Claim it to get a verified publisher badge, a free copy of our full audit findings, and direct contact for any high-priority issues we find. Or connect your repo for our deepest verification, Live Monitored: read-only, revoke anytime. What we access →
Install from
The grade above is for the source repository. Registries can serve a different version, so we mark the ones we were not able to read.
These names and descriptions are the publisher's own, read from the source code. We print them as written. Our assessment is the findings above, not this list.
index_knowledgeRebuild the vector index from all markdown files in the knowledge base. Scans companies/, people.md, projects.md, meetings/ and indexes all content into ChromaDB with rich metadata for semantic search and filtering. Call this after adding or updating knowledge base files.
upsert_knowledgeIncrementally update the vector index — only re-index changed files. Compares file MD5 hashes to detect additions, modifications, and deletions. Much faster than index_knowledge() when only a few files changed.
search_knowledgeSearch the knowledge base using semantic similarity with optional filters.
generate_imageGenerate an image from a text description using Gemini (nano banana). Use this when the user needs illustrations, diagrams, icons, or any visual content. The image will be saved to the current working directory.
generate_pptGenerate a complete PPT presentation from a topic and optional context. Plans an outline using Gemini, generates slide images, and outputs a PDF.
transcribe_audioTranscribe an audio/video file to text using local Whisper. Automatically detects multiple speakers using pyannote and matches against registered voiceprints. Unknown speakers are labeled as "未知说话人1", "未知说话人2", etc.
register_voiceprintRegister a person's voiceprint from an audio file. The audio should contain only one person speaking clearly for 20-30 seconds. The voiceprint will be saved and used to identify this person in future meeting transcriptions.
GEMINI_API_KEYyour_google_ai_studio_keyOPENROUTER_BASE_URL"": "https://openrouter.ai/api/v1",OPENROUTER_API_KEYyour_openrouter_keyHF_TOKENyour_huggingface_tokenTool annotations
No tools have read-only/destructive annotations
Add readOnlyHint or destructiveHint annotations to every tool so hosts can warn users before invoking.
All four hints declared on every tool
7/7 tools missing one or more hints — index_knowledge (missing: readOnlyHint, destructiveHint, idempotentHint, openWorldHint); upsert_knowledge (missing: readOnlyHint, destructiveHint, idempotentHint, openWorldHint); search_knowledge (missing: readOnlyHint, destructiveHint, idempotentHint, openWorldHint), +4 more. OpenAI's directory rejects tools where any of the four hints are missing or non-boolean.
For every tool, set all four hints (readOnlyHint, destructiveHint, idempotentHint, openWorldHint) to explicit true/false values that match the handler’s actual behaviour.
Destructive tools are labelled
2 tools perform destructive updates without destructiveHint — transcribe_audio deletes at line 856 (os.unlink(tmp.name)); register_voiceprint deletes at line 1004 (os.unlink(wav_path))
Add destructiveHint:true to any tool whose handler calls .delete(), .upsert(), .update(), unlink, rm, DELETE, DROP, REPLACE INTO, or any operation that overwrites existing data.
Descriptions match behaviour
1 tool describes read intent but its handler mutates — index_knowledge (line 242: hashes_path.write_text(json.dumps(hashes, ensure_ascii=False, indent=2)))
Rename the tool, rewrite the description, or move the side-effect into a separate clearly-named tool.
Tool inputs are validated
5/7 tool handlers declare input schemas (71%)
Declare an inputSchema with zod/joi/yup on every tool definition.
Tool handlers catch errors
6/7 tool handlers wrap calls in try/catch (86%)
Wrap each tool handler body in try/catch and return a structured error response.
License file
No license file
Add a LICENSE file (MIT, Apache-2.0, etc.).
Tests exist
No test files found
Add tests that exercise each declared tool.
Claim the listing to review these findings one by one and send us a correction where you disagree, straight to the team. Claiming also means we tell you when the grade moves, and reach you first if we find anything urgent.
[](https://m8ven.ai/mcp/ryeliu/worklab-tools)?variant=verified from the URL.Vetting this one by hand? Tool Check is an MCP that scores other MCPs. Add it once and ask Claude, ChatGPT, or any MCP client to grade a server, surface CVEs, check the publisher, and suggest safer alternatives — before you install.
https://m8ven.ai/api/mcp/tool-check