Proposed README edits - #18
Open
a-effort wants to merge 4 commits into
Open
Conversation
a-effort
marked this pull request as ready for review
August 12, 2026 19:44
added 4 commits
August 12, 2026 17:29
The step didn't name a command, which read as if this repo had its own way to bring ContextForge up. Name make dev and its default port, and say explicitly it's a separate clone. Signed-off-by: Anna Effort <anna.effort@ibm.com>
.env.example's 4444 default matches ContextForge's production make serve default, not make dev's :8000 - following the doc literally against a make dev instance pointed the BFF at the wrong port. Signed-off-by: Anna Effort <anna.effort@ibm.com>
The repo names are similar enough that shorthand like "ContextForge" and "this repo" was ambiguous about which project was meant. Spell out mcp-context-forge and contextforge-web-ui explicitly throughout. Signed-off-by: Anna Effort <anna.effort@ibm.com>
Signed-off-by: AE <ae@AEs-MacBook-Pro.local> Signed-off-by: Anna Effort <anna.effort@ibm.com>
a-effort
force-pushed
the
readme/clarify-contextforge-dev-step
branch
from
August 13, 2026 00:29
eebd633 to
d3583aa
Compare
marekdano
reviewed
Aug 13, 2026
Comment on lines
+48
to
+49
| In that repo, `make dev` boots it on `:8000` by default. Note whatever | ||
| port it ends up listening on for the next step. |
Contributor
There was a problem hiding this comment.
We can add something like
cd /path/to/mcp-context-forge
make dev # Listens on :8000 by default
Comment on lines
+59
to
+63
| - `FASTAPI_URL`: point it at whatever host:port mcp-context-forge is | ||
| listening on from step 1. `.env.example`'s default (`4444`) is | ||
| mcp-context-forge's own **production** default (`make serve`); `make dev` | ||
| (the usual path for local dev) listens on `:8000` instead: confirm | ||
| against your actual run rather than assuming either. |
Contributor
There was a problem hiding this comment.
Would it be good if we had a table here?
| Command | Port | Use Case |
|---|---|---|
make dev |
:8000 |
Local development (recommended) |
make serve |
:4444 |
Production mode |
gcgoncalves
reviewed
Aug 13, 2026
gcgoncalves
left a comment
gcgoncalves
left a comment
Contributor
There was a problem hiding this comment.
The current version uses ContextForge, and the proposed mcp-context-forge. Both here are old terms, we're trying to distance away from MCP - as the gateway is broader in scope. Let's use just Context Forge.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
3 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Changes proposed:
make devand its default port (:8000).FASTAPI_URLguidance:.env.example's4444default is mcp-context-forge's production default (make serve), notmake dev's:8000. Following the doc literally against amake devinstance pointed the BFF at the wrong port.mcp-context-forge(upstream gateway) fromcontextforge-web-ui(this repo) throughout. The similar names made several "ContextForge" / "this repo" references ambiguous about which project was meant.