{"id":36969319,"url":"https://github.com/contextforge-org/contextforge-cli","last_synced_at":"2026-01-27T03:12:53.478Z","repository":{"id":329181855,"uuid":"1094530103","full_name":"contextforge-org/contextforge-cli","owner":"contextforge-org","description":"ContextForge CLI","archived":false,"fork":false,"pushed_at":"2025-12-19T23:01:53.000Z","size":305,"stargazers_count":2,"open_issues_count":7,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-01-13T21:36:12.695Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/contextforge-org.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2025-11-11T20:42:27.000Z","updated_at":"2025-12-23T17:05:14.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/contextforge-org/contextforge-cli","commit_stats":null,"previous_names":["contextforge-org/contextforge-cli"],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/contextforge-org/contextforge-cli","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/contextforge-org%2Fcontextforge-cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/contextforge-org%2Fcontextforge-cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/contextforge-org%2Fcontextforge-cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/contextforge-org%2Fcontextforge-cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/contextforge-org","download_url":"https://codeload.github.com/contextforge-org/contextforge-cli/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/contextforge-org%2Fcontextforge-cli/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28798687,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-27T01:07:07.743Z","status":"online","status_checked_at":"2026-01-27T02:00:07.755Z","response_time":168,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-01-13T21:05:40.372Z","updated_at":"2026-01-27T03:12:53.461Z","avatar_url":"https://github.com/contextforge-org.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ContextForge CLI\n\n\u003c!--\nTODO: Enable once pushed to PyPI\n[![PyPI version](https://img.shields.io/pypi/v/cforge.svg)](https://pypi.org/project/cforge/)\n--\u003e\n[![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)\n[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](LICENSE)\n\n**A command-line interface for managing [ContextForge MCP Gateway](https://github.com/IBM/mcp-context-forge)** — seamlessly manage local or hosted MCP servers, tools, resources, prompts, and Agent-to-Agent services.\n\n\u003e **Part of the [ContextForge](https://github.com/IBM/mcp-context-forge) ecosystem** by IBM\n\n---\n\n## Quick Start\n\n### Installation\n\n\u003c!--\nTODO: Enable once pushed to PyPI\n```bash\n# Using pip\npip install cforge\n\n# Using uv (recommended)\nuv pip install cforge\n```\n--\u003e\n\n```bash\npip install git+https://github.com/contextforge-org/contextforge-cli.git\n```\n\n### First Steps\n\n```bash\n# Authenticate with your gateway\ncforge login\n\n# List available tools\ncforge tools list\n\n# Start a local gateway server\ncforge serve\n```\n\n---\n\n## Features\n\n| Capability | Description |\n|------------|-------------|\n| **MCP Server Management** | Register, configure, and monitor MCP server peers |\n| **Tool Operations** | Create, update, toggle, and organize MCP tools |\n| **Resource Management** | Manage MCP resources with subscription support |\n| **Prompt Library** | Store, organize, and execute prompt templates |\n| **Virtual Servers** | Build composite servers from multiple sources |\n| **A2A Integration** | Manage and invoke Agent-to-Agent services |\n| **Config Import/Export** | Backup and migrate gateway configurations |\n\n---\n\n## Commands\n\n### Authentication \u0026 Settings\n\n```bash\ncforge login              # Authenticate with the gateway\ncforge logout             # Clear saved credentials\ncforge whoami             # Show current user\ncforge version            # Display CLI version\n```\n\n### Resource Management\n\nTo see the full set of available comands, use `cforge --help`. To see the options for a sub command, use `cforge \u003ccommand\u003e --help`.\n\nHere are some examples:\n\n```bash\n# Tools\ncforge tools list [--mcp-server-id ID] [--json]\ncforge tools get \u003ctool-id\u003e\ncforge tools create [file.json]\ncforge tools toggle \u003ctool-id\u003e\n\n# Resources\ncforge resources list\ncforge resources create [file.json]\n\n# Prompts\ncforge prompts list\ncforge prompts execute \u003cprompt-id\u003e\n\n# MCP Servers\ncforge mcp-servers list\ncforge mcp-servers update \u003cmcp-server-id\u003e [file.json]\n```\n\n### Server Operations\n\n```bash\n# Start the gateway server\ncforge serve [--host HOST] [--port PORT] [--reload]\n\n# Configuration management\ncforge export [--output file.json]\ncforge import \u003cfile.json\u003e\ncforge support-bundle      # Generate diagnostics\n```\n\n### Output Options\n\nMost commands support:\n- `--json` — Output raw JSON instead of formatted tables\n- `--mcp-server-id` — Filter by specific MCP server\n- `--active-only` — Show only enabled items\n\n---\n\n## Configuration\n\n### Environment Variables\n\n| Variable | Default | Description |\n|----------|---------|-------------|\n| `CONTEXTFORGE_HOME` | `~/.contextforge` | Configuration directory |\n| `MCG_HOST` | `localhost` | Gateway host |\n| `MCG_PORT` | `8000` | Gateway port |\n\nAdditionally, all configuration in `mcpgateway` can be set via the environment or via `CONTEXTFORGE_HOME/.env`. For full details, see [the docs](https://ibm.github.io/mcp-context-forge/#complete-migration-guide).\n\n---\n\n## Development\n\n### Setup\n\n```bash\ngit clone https://github.com/contextforge-org/contextforge-cli.git\ncd contextforge-cli\npip install -e \".[dev]\"\n```\n\n### Running Tests\n\n```bash\npytest\n```\n\n---\n\n## Related Projects\n\n- **[ContextForge MCP Gateway](https://github.com/IBM/mcp-context-forge)** — The gateway server this CLI manages\n- **[MCP Specification](https://modelcontextprotocol.io/)** — Model Context Protocol documentation\n\n---\n\n## License\n\nApache 2.0 — See [LICENSE](LICENSE) for details.\n\n---\n\n## Contributing\n\nContributions welcome! Please see the [ContextForge contributing guidelines](https://github.com/IBM/mcp-context-forge/blob/main/CONTRIBUTING.md).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcontextforge-org%2Fcontextforge-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcontextforge-org%2Fcontextforge-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcontextforge-org%2Fcontextforge-cli/lists"}