This release is a pre-release and may not be stable for production use.
forge-mcp
The MCP server for Forge — a deterministic, stdlib-only transport that exposes the whole Forge SDK to any MCP client. JSON-RPC 2.0 over stdio, six tools, one SDK call each, zero business logic.
This package is the ecosystem proof behind the SDK boundary: it is a
separate, installable package that consumes only the public
forge.* surface — no kernel internals.
Install
pip install forge-foundation forge-mcp-base
Use
forge-mcp -d myproject
Or from Python:
python -m forge_mcp.server -d myproject
An MCP client (Claude, Hermes, the mcp SDK, any editor) connects over
stdio and gets six tools — forge_next, forge_context,
forge_propose, forge_verify, forge_query, forge_replay — each a
thin pass-through to one SDK method. The kernel decides; this
translates.
Reference client
A walk-through client that proves the server is a real MCP server:
python -m forge_mcp.mcp_client -d myproject
It performs the handshake, lists tools, and drives the six-tool loop over the wire.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file forge_mcp_base-0.1.0a4.tar.gz.
File metadata
- Download URL: forge_mcp_base-0.1.0a4.tar.gz
- Upload date:
- Size: 9.0 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
uv/0.12.0 {"installer":{"name":"uv","version":"0.12.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
8fd6d91cc6ad8555edd36ab26c2c5da1337153fa4cbfc9155a8f6744bfe0f16f
|
|
| MD5 |
cd5a25d37706f5071ffd0ec148585a93
|
|
| BLAKE2b-256 |
2c07585395cf506f024171911f3ea577b40324fa1b6dc6377939329e96d91594
|
File details
Details for the file forge_mcp_base-0.1.0a4-py3-none-any.whl.
File metadata
- Download URL: forge_mcp_base-0.1.0a4-py3-none-any.whl
- Upload date:
- Size: 9.9 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
uv/0.12.0 {"installer":{"name":"uv","version":"0.12.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
1ff84fd4e5924a84da62f81b91317dc23d89597a3c5d921406f72e9a7d0695b1
|
|
| MD5 |
2c1a4486da7975d4ea3cdce88099594f
|
|
| BLAKE2b-256 |
5d046a04efab10b13808ab241744110174dc2e24e02cc47dd64739aa7da66443
|
