Skip to main content

MCP server for the forge-manager skill — multi-platform forge operations layer (GitHub / Forgejo+Codeberg / GitLab / local docs store)

Project description

claude-skills-mcp-dev

Private dev repo for the active-claude-github Claude Code skill's MCP server. Consumer docs live at the publish target: https://codeberg.org/telejester-skills/telejester-claude-skills.

This repo is where MCP server development happens — Issues, Discussions, CI, Bazel build graph, tests. Releases are published to the publish-target repo linked above.

What lives here

  • Python package active_claude_github_mcp/ implementing the MCP tool surface.
  • tests/ — Bazel-orchestrated unit and integration tests in two layers: helper-level (#79, ephemeral repos) and tool-level (#89, persistent fixture repo at telejester-test-org/integration-fixture). See CONTRIBUTING.md for the build and test conventions and §Persistent fixture repo for the provisioning protocol.
  • .github/workflows/ — CI (bazel test + bazel coverage on every PR; workflow_dispatch live-GitHub integration tests).
  • Issues / Discussions / Project board cross-referenced with the skill dev repo at https://github.com/orgs/telejester-claude-skills/projects/1.

Bootstrapping a new project

scaffold_project is the MCP tool that stands up a new managed project end-to-end: creates the <org>/<name> public + <org>/<name>-dev private repo pair, seeds the standard label set, enables Discussions on the dev repo, creates a ProjectV2 board (linked to both repos) with the canonical Backlog → In Progress → In Review → Done / Parked Status field, seeds the Project and Session-Lock Discussions, and writes .claude/github-config.json with every resolved ID.

The tool is idempotent and pauses for exactly one manual step: creating the five Discussion categories (Project, Architecture, UX / UI, Ideas, claude-use-only) via the dev-repo's Settings page, which GitHub exposes no API for. Re-run the tool once the categories exist and it picks up where it left off.

The exact bootstrap flow — invocation, expected pauses, and follow-up open_session — lives in the consumer skill's §Self-Bootstrap Instructions: https://codeberg.org/telejester-skills/telejester-claude-skills.

Multi-repo relations (1.3.0+)

github-config.json accepts a related_repos list that tags each connected repo with one of six relationship types. The server uses these tags at dispatch time to gate cross-repo mutations per the skill's §Cross-repo work protocol:

Type Gate
subsystem, publish_target, sibling, neighbor Allowed
cousin (different org, skill-managed) Blocked — requires explicit user permission per operation
foreign (no write access) Blocked — treat as informational only

Blocks surface as a non-buffered OperationError with manual_step populated; no GitHub calls are issued. Unknown targets (not declared in related_repos) pass through — the preflight doesn't invent policy for undeclared repos.

The pre-1.3.0 contribution_target type still parses for backward compat but emits a DeprecationWarning at load. Migrate each entry to its precise sub-type at next config edit.

Contributing

See CONTRIBUTING.md.

Related repos

License

Apache License 2.0 — © 2026 Telejester.

Project details


Release history Release notifications | RSS feed

Download files

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

Source Distribution

forge_manager_mcp-4.10.0a2.tar.gz (9.5 MB view details)

Uploaded Source

Built Distribution

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

forge_manager_mcp-4.10.0a2-py3-none-any.whl (9.4 MB view details)

Uploaded Python 3

File details

Details for the file forge_manager_mcp-4.10.0a2.tar.gz.

File metadata

  • Download URL: forge_manager_mcp-4.10.0a2.tar.gz
  • Upload date:
  • Size: 9.5 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.6

File hashes

Hashes for forge_manager_mcp-4.10.0a2.tar.gz
Algorithm Hash digest
SHA256 136df69a36cec27f1d9dc7e2367bd6709a3cd13aa43a1ae49ab47d85cf24e22c
MD5 fbd89f80a222572c3c4d3b8d8d1f95ed
BLAKE2b-256 77c4788ccf6210b4ee6e9f0002c89c8ce98a73c90da7faa79cc5d80ae8a66ea5

See more details on using hashes here.

File details

Details for the file forge_manager_mcp-4.10.0a2-py3-none-any.whl.

File metadata

File hashes

Hashes for forge_manager_mcp-4.10.0a2-py3-none-any.whl
Algorithm Hash digest
SHA256 950d2625b60c21ac56a58ab0c16201622a42f634470014d368ac6341d0ce4f1b
MD5 92f0357765b59e797bbbd98d389b5c9e
BLAKE2b-256 42b0d74d30e49d3b63d9b23f1f15aeb90b16b7c997575bf1fdd1b629d982a6d9

See more details on using hashes here.

Supported by

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