Skip to main content
Pre-release

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.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

forge_mcp_base-0.1.0a2.tar.gz (8.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

forge_mcp_base-0.1.0a2-py3-none-any.whl (9.7 kB view details)

Uploaded Python 3

File details

Details for the file forge_mcp_base-0.1.0a2.tar.gz.

File metadata

  • Download URL: forge_mcp_base-0.1.0a2.tar.gz
  • Upload date:
  • Size: 8.8 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

Hashes for forge_mcp_base-0.1.0a2.tar.gz
Algorithm Hash digest
SHA256 a755cae4ce241e4456083285850132a0ad4cd36b1ea52d39803e04675a956549
MD5 0a7fdae8ac2450d0886dfa9409b2febf
BLAKE2b-256 6f15b8156851364ec4a4667ea1bb07eacf22dfd2382ab50e310f09daf63ac536

See more details on using hashes here.

File details

Details for the file forge_mcp_base-0.1.0a2-py3-none-any.whl.

File metadata

  • Download URL: forge_mcp_base-0.1.0a2-py3-none-any.whl
  • Upload date:
  • Size: 9.7 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

Hashes for forge_mcp_base-0.1.0a2-py3-none-any.whl
Algorithm Hash digest
SHA256 becef39967a599bff0e70fac7d3040b951927be9245f8e511e97dca48746732d
MD5 8a1358f122b6377ae6ef303dc297a86d
BLAKE2b-256 51fc05280bb5db1cd8d49a0345f84b708def3ae89eba3069bedc7847fa507fe2

See more details on using hashes here.

Release history Release notifications | RSS feed

This release

0.1.0a2 This release

2 files

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page