Brohammad / Brohammad/VoxForge

Document how to enable MCP tools in the production image

Open Beginner friendly
#16 0 comments 0 reactions 0 assignees View on GitHub
documentation good first issue
Dominant language
Python
Stars
4
Forks
1
Avg merge
5d 13m
Merged PRs (30d)
10

Description

## Task

Known limitation: MCP servers need `pip install -e ".[mcp]"` in the production image when `MCP_SERVERS_CONFIG` is set. That is easy to miss during a VPS deploy.

## Files

- `docs/FAQ.md`
- `docs/CONFIGURATION.md` (`MCP_SERVERS_CONFIG`)
- `docs/architecture/mcp-tool-router.md` or `docs/architecture/mcp-runtime-discovery.md`
- `docs/release/known-limitations.md` (already mentions it; link the FAQ)

## Acceptance criteria

- [ ] FAQ answers “How do I turn on MCP tools in production?”
- [ ] Points at the extra, env var, and that the default prod image may not include it
- [ ] No behavior change

Contributor guide

Open the contributing guide

Research direction

Read docs/FAQ.md and the MCP_SERVERS_CONFIG section in docs/CONFIGURATION.md first, then compare the MCP architecture pages and docs/release/known-limitations.md. Document how to enable MCP tools in the production image, including pip install -e ".[mcp]", the environment variable, and the image limitation; link the FAQ from the known-limitations page and verify there is no behavior change.

Written by the indexing model from the issue text.

Assessment

Tech stack
docker, python
Domain
devops, documentation
Issue type
Documentation
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Active
Clarity
Clearly specified
Newbie friendliness
88/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.