Reported issues for molecare-mcp

Pod holds 16 of 17 problems reported by people outside the maintainer team. Issues filed by the project's own owners, members and collaborators are excluded entirely — a maintainer's release checklist is not a warning to a prospective user.

Back to molecare-mcp.

Most discussed

Add --version and --help flags to the CLI

The package installs a molecare-mcp binary. Running it with any argument — including --version or --help — starts a stdio server that sits silently waiting for JSON-RPC input.

That is correct behaviour for an MCP server and confusing behaviour for a command. Someone who has just installed the package and wants to check what they got has no way to ask, and the silence reads as a hang.

What to do

Parse process.argv before starting the transport in src/index.ts:

• --version / `-v

Read the thread · 2026-08-24 · open · 1 comment

Delete the unused express middleware, or wire it up

src/middleware/rateLimitMiddleware.ts imports express and defines a Router. Nothing imports it — src/index.ts never references the file.

Rate limiting is genuinely implemented, just elsewhere: src/services/RateLimitService.ts, applied to tool calls at src/index.ts:1049. So the middleware is dead code that:

• drags express into dependencies for a stdio server that never serves HTTP routes
• carries three TODO: Add admin authentication check comments for admin endpoints that do not

Read the thread · 2026-08-24 · closed · 1 comment

i18n: Optional localization of MCP tool descriptions

Problem

~90+ tools in src/index.ts expose English description strings to MCP hosts. Those descriptions steer how models choose tools. Non-English hosts may benefit from translated descriptions — but this is lower priority than medical KB copy.

Open design questions

• Does the MCP protocol / host ecosystem expect tool schemas in one language only?
• Should we ship multiple description locales, or keep English schemas and only localize results?
• Risk: divergent translations could c

Read the thread · 2026-08-24 · open · 0 comments

i18n: Document translation workflow in CONTRIBUTING.md

Problem

CONTRIBUTING.md does not explain how to add or update translations for educational content, tool-facing copy, or disclaimers.

Acceptance criteria

• Section “Translations / i18n” in CONTRIBUTING.md
• Where locale files live, how to add a language, how to test
• Clinical-safety rule: disclaimer translations need maintainer review
• Link to open i18n issues / preferred languages

Good first issue?

Yes once locale file layout exists (or document the planned layout

Read the thread · 2026-08-24 · open · 0 comments

i18n: Add locale parameter to search_medical_info and knowledge resources

Problem

Tools like search_medical_info and MCP resources always return English. Clients have no way to request another language even after locale files exist.

Why it matters

MCP hosts and agents often run in a user’s language. Without a locale hook, extracted translations cannot be selected at runtime.

Proposed approach

• Optional tool argument locale (BCP 47, e.g. en, es, ar) with fallback to en
• Optional resource URI query or negotiated locale for `molecare://knowledge/

Read the thread · 2026-08-24 · open · 0 comments

i18n: Localize clinical-safety disclaimers on knowledge resources

Problem

Every knowledge resource in src/resources/medical-kb.ts ends with an English disclaimer such as:

This information is for educational purposes only and does not constitute medical advice.

Similar wording appears in README / package description. There is no approved translated set of disclaimers.

Why it matters

Disclaimers are a clinical-safety requirement for this repo (“Not a medical device”). A partial or casual translation that softens meaning is worse than English-only. C

Read the thread · 2026-08-24 · open · 0 comments

i18n: Extract medical knowledge base into locale files (English-only today)

Problem

Educational dermatology content lives as hardcoded English strings in src/resources/medical-kb.ts:

• KNOWLEDGE_BASE entries (asymmetry, border, color, diameter, evolution, melanoma, skin-types, sunscreen, self-examination, uv-protection)
• MCP resources (molecare://knowledge/abcde-criteria, skin-types, prevention-tips, when-to-see-doctor) including titles, criteria text, tips, and disclaimers

There is no locale layer. Non-English users (and LLM clients configured for oth

Read the thread · 2026-08-24 · open · 0 comments

Verify the registry listing matches what npm shipped, after publishing

Follow-on from the OIDC publishing workflow in .github/workflows/publish-mcp-registry.yml.

The workflow checks before publishing that the version declared in server.json exists on npm and that its mcpName matches. Nothing checks after publishing that the registry actually reflects what was intended.

The failure this guards against is quiet: a registry entry pointing at a version that was later unpublished or deprecated, or a server.json that drifts from package.json across releas

Read the thread · 2026-08-24 · open · 0 comments

Most recent

Integration test harness that exercises every tool in mock mode

Complements #1 rather than replacing it — #1 is unit tests, this is end-to-end.

Because every tool falls back to clearly-labelled mock data when its backend is unconfigured, the entire 53-tool surface is testable with no credentials, no database and no AWS account. That is an unusually good position to be in and it is currently unused.

What to do

Using the MCP SDK's client, spawn the built server over stdio and:

• call tools/list and assert the expected tool count
• call every tool with

Read the thread · 2026-08-24 · closed · 0 comments

Add MCP prompts

The server declares tools and resources capabilities but no prompts — there are zero references to the prompts capability in src/index.ts.

Prompts are arguably the part of MCP best suited to educational content, because they let the server ship a well-constructed question rather than depending on the user knowing what to ask. Somebody exploring skin-health knowledge often does not know the right question, which is exactly the gap a prompt fills.

Candidates

• **Walk through ABCDE cr

Read the thread · 2026-08-24 · open · 0 comments

Tool profiles: let people load only the dermatology tools

The server registers 53 tools. Roughly:

• 9 dermatology knowledge (search_medical_info, lookup_medical_concept, map_snomed_to_icd10, …)
• 5 MoleCare product data (get_user_moles, compare_moles, …)
• ~35 MoleCare's own infrastructure (EC2, MLflow, Feast, CI/CD, database, app status)

Someone who installs this for SNOMED lookups gets 44 tools they will never call. Every one of them is serialised into the model's context on every request, which costs tokens and makes tool sel

Read the thread · 2026-08-24 · open · 0 comments

Cite sources for every SNOMED CT and ICD-10 mapping

src/resources/medical-kb.ts hardcodes SNOMED CT concepts, ICD-10 codes and the mappings between them, with no provenance recorded anywhere.

For a server whose entire value proposition is educational accuracy, a reader currently cannot tell where 372244006 → C43 came from, which SNOMED release it reflects, or when it was last checked. Terminology releases change: concepts get inactivated, mappings get revised. Undated clinical reference data quietly goes stale.

What to do

• Record the s

Read the thread · 2026-08-24 · open · 0 comments

Add MCP tool annotations to all tools

Every tool this server exposes is read-only — nothing mutates state anywhere. The MCP specification defines tool annotations (readOnlyHint, destructiveHint, idempotentHint, openWorldHint) that let a client decide what it can safely call without interrupting the user for approval.

Right now the server declares almost none of them. The practical cost is that a client has to prompt on every single call, including things like map_snomed_to_icd10 which reads from a static lookup table and

Read the thread · 2026-08-24 · closed · 0 comments

Expand the dermatology knowledge resources

The server currently exposes four knowledge resources under molecare://knowledge/:

• abcde-criteria
• skin-types
• prevention-tips
• when-to-see-doctor

There is room for more educational material — sun protection factors, common benign lesions and how they differ from concerning ones, what actually happens at a dermatology appointment, self-examination technique.

**Before you start, please read the clinical-safety section of [CONTRIBUTING.md](https://github.com/MoleCare/molecare-mcp

Read the thread · 2026-08-23 · open · 0 comments

Add a CI workflow

There is no .github/workflows/ directory, so nothing is checked automatically on push or pull request.

What would help

A single workflow running on push and pull request that does:

• npm ci
• npm run build (TypeScript must compile clean)
• npm test once #1 lands — feel free to leave a placeholder step until then

A useful extra: start the server and assert it answers an initialize and tools/list request over stdio. That catches runtime breakage the type checker misses. It shou

Read the thread · 2026-08-23 · closed · 0 comments

Wire up dotenv so .env is actually loaded

The README points users at .env.example, and .gitignore is set up to keep .env out of git — but nothing in the code ever loads a .env file. dotenv is not a dependency and is not imported anywhere.

The practical effect is that copying .env.example to .env does nothing. Variables only take effect if you export them in your shell first, which is not what the docs imply.

What would help

Add dotenv and load it once at the top of src/index.ts, before any client is constructe

Read the thread · 2026-08-23 · closed · 0 comments

The remaining reports are on the project's issue tracker.