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.0a1.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.0a1-py3-none-any.whl (9.7 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: forge_mcp_base-0.1.0a1.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.0a1.tar.gz
Algorithm Hash digest
SHA256 389b3ad1d4fcc029afba5c5d6b6d34ae9408d4147107efffda220f98d3f13386
MD5 a499712eee309c8ce8264438e65c4dd6
BLAKE2b-256 b33ed1a7be08619671217bd369eefcee7a5153e97d1d70d995496854b00a9137

See more details on using hashes here.

File details

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

File metadata

  • Download URL: forge_mcp_base-0.1.0a1-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.0a1-py3-none-any.whl
Algorithm Hash digest
SHA256 0da82c639daa6da1627821126a9bd5341d8f86faab44556ec22fb56ddb04e495
MD5 920f006dffd80ab600246c8c46687a3b
BLAKE2b-256 7bf35a1dd44031a0306ea8addb88d4ebd0f8abb368d498c7c202d3f0b16c0d6c

See more details on using hashes here.

Release history Release notifications | RSS feed

This release

0.1.0a1 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