{"_id":"@anketpsingh/codeforge-mcp","_rev":"2-4353b88e8d24233f22353b12fd1b3eeb","name":"@anketpsingh/codeforge-mcp","dist-tags":{"latest":"0.1.1"},"versions":{"0.1.0":{"name":"@anketpsingh/codeforge-mcp","version":"0.1.0","keywords":["mcp","model-context-protocol","claude","codeforge","senior-engineer","tech-lead","jira","code-review","rca"],"author":"","license":"MIT","_id":"@anketpsingh/codeforge-mcp@0.1.0","maintainers":[{"name":"anketpsingh","email":"singhanket5101@gmail.com"}],"homepage":"https://github.com/ThakurAnketPratapSingh/codeforge-mcp#readme","bugs":{"url":"https://github.com/ThakurAnketPratapSingh/codeforge-mcp/issues"},"bin":{"codeforge-mcp":"dist/index.js"},"dist":{"shasum":"bdd8275a0e111b66becf24a8aecf672490a04c65","tarball":"https://registry.npmjs.org/@anketpsingh/codeforge-mcp/-/codeforge-mcp-0.1.0.tgz","fileCount":49,"integrity":"sha512-RA224MnTKXEFob6Oa4d+2tEik4p7OgGq8X5/zLDjJGt0cQxoHsCavieBugxwvkdHrFFP1PW3OBYQzTYsLWGT2w==","signatures":[{"sig":"MEQCIBRrieog3G8Vkctxrt8RxcrcxXniE5f9GbmGf31SPSiLAiAYh71Yt4Y2nK/NoyTnU3da+5ez0UgdBXbH4BJIrc/khg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":143030},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"9874d18370251c506f9527bc4d2f1ba5a4e7c7f9","scripts":{"dev":"tsc --watch","build":"tsc","clean":"rimraf dist","start":"node dist/index.js","release:major":"npm version major && npm publish","release:minor":"npm version minor && npm publish","release:patch":"npm version patch && npm publish","prepublishOnly":"npm run clean && npm run build"},"_npmUser":{"name":"anketpsingh","email":"singhanket5101@gmail.com"},"repository":{"url":"git+https://github.com/ThakurAnketPratapSingh/codeforge-mcp.git","type":"git"},"_npmVersion":"11.12.1","description":"CodeForge — MCP server exposing Senior Software Engineer / Tech Lead capabilities: code generation, code review, bug analysis, RCA, Jira integration, architecture guidance, DevOps review, and documentation.","directories":{},"_nodeVersion":"24.15.0","dependencies":{"zod":"^3.23.8","node-fetch":"^3.3.2","zod-to-json-schema":"^3.23.5","@modelcontextprotocol/sdk":"^1.0.4"},"publishConfig":{"access":"public","registry":"https://registry.npmjs.org/"},"_hasShrinkwrap":false,"devDependencies":{"rimraf":"^6.0.1","typescript":"^5.7.2","@types/node":"^22.10.2"},"_npmOperationalInternal":{"tmp":"tmp/codeforge-mcp_0.1.0_1782640013401_0.8448576729795412","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@anketpsingh/codeforge-mcp","version":"0.1.1","description":"CodeForge — MCP server exposing Senior Software Engineer / Tech Lead capabilities: code generation, code review, bug analysis, RCA, Jira integration, architecture guidance, DevOps review, and documentation.","type":"module","main":"dist/index.js","bin":{"codeforge-mcp":"dist/index.js"},"scripts":{"build":"tsc","start":"node dist/index.js","dev":"tsc --watch","clean":"rimraf dist","prepublishOnly":"npm run clean && npm run build","release:patch":"npm version patch && npm publish","release:minor":"npm version minor && npm publish","release:major":"npm version major && npm publish"},"publishConfig":{"registry":"https://registry.npmjs.org/","access":"public"},"repository":{"type":"git","url":"git+https://github.com/ThakurAnketPratapSingh/codeforge-mcp.git"},"keywords":["mcp","model-context-protocol","claude","codeforge","senior-engineer","tech-lead","jira","code-review","rca"],"author":"","license":"MIT","dependencies":{"@modelcontextprotocol/sdk":"^1.0.4","node-fetch":"^3.3.2","zod":"^3.23.8","zod-to-json-schema":"^3.23.5"},"devDependencies":{"@types/node":"^22.10.2","rimraf":"^6.0.1","typescript":"^5.7.2"},"engines":{"node":">=18.0.0"},"gitHead":"423fe71ae9d6549e5b955922ead7705bceabe397","types":"./dist/index.d.ts","_id":"@anketpsingh/codeforge-mcp@0.1.1","bugs":{"url":"https://github.com/ThakurAnketPratapSingh/codeforge-mcp/issues"},"homepage":"https://github.com/ThakurAnketPratapSingh/codeforge-mcp#readme","_nodeVersion":"24.15.0","_npmVersion":"11.12.1","dist":{"integrity":"sha512-SSGQiTmU8nUsp925Opj1KLr9wtOZG0e5E/GMxTeWkHiNTZ42KEywHv/I6xj1nKgzYnOAxQzOIG7UBhSwWthUXQ==","shasum":"a16766fcad0ccf7c58e950aa23ec93a0a9505fdd","tarball":"https://registry.npmjs.org/@anketpsingh/codeforge-mcp/-/codeforge-mcp-0.1.1.tgz","fileCount":52,"unpackedSize":155832,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQC8vFCjnhlIZ0/n0R8Y0T/65fYS9AnqMtzUH4qMftYdCgIgP8K+rKky07D5IQ3j81l34AW8yDQdQGpjgDHqA27UtFI="}]},"_npmUser":{"name":"anketpsingh","email":"singhanket5101@gmail.com"},"directories":{},"maintainers":[{"name":"anketpsingh","email":"singhanket5101@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/codeforge-mcp_0.1.1_1782640925681_0.9039934590197767"},"_hasShrinkwrap":false}},"time":{"created":"2026-06-28T09:46:53.268Z","modified":"2026-06-28T10:02:05.964Z","0.1.0":"2026-06-28T09:46:53.540Z","0.1.1":"2026-06-28T10:02:05.841Z"},"bugs":{"url":"https://github.com/ThakurAnketPratapSingh/codeforge-mcp/issues"},"license":"MIT","homepage":"https://github.com/ThakurAnketPratapSingh/codeforge-mcp#readme","keywords":["mcp","model-context-protocol","claude","codeforge","senior-engineer","tech-lead","jira","code-review","rca"],"repository":{"type":"git","url":"git+https://github.com/ThakurAnketPratapSingh/codeforge-mcp.git"},"description":"CodeForge — MCP server exposing Senior Software Engineer / Tech Lead capabilities: code generation, code review, bug analysis, RCA, Jira integration, architecture guidance, DevOps review, and documentation.","maintainers":[{"name":"anketpsingh","email":"singhanket5101@gmail.com"}],"readme":"# codeforge-mcp\n\n**CodeForge** — an MCP (Model Context Protocol) server that exposes Senior Software Engineer / Technical Lead capabilities as individual tools. Any MCP-compatible client — Claude Desktop, Cursor, VS Code, Claude Code — can call these tools to delegate engineering tasks to a model playing a senior-engineer persona.\n\nThe server is **prompt-mediated** for reasoning tools: code generation, code review, RCA, etc. each return a structured prompt that locks the host LLM into the senior-engineer persona and a strict output schema. The reasoning happens in the client's LLM, so no second LLM API key is needed.\n\nJira tools call the Jira REST API directly.\n\n---\n\n## Tools exposed\n\n| Tool | Purpose |\n| --- | --- |\n| `generate_code` | Generate clean, scalable, production-ready code with tests, logging, and docs. |\n| `scaffold_service` | Scaffold a new Comviva Spring Boot microservice (pom, packaging, logging, Kafka, Consul, OpenAPI) per the standards in [`standards/comviva-springboot.md`](standards/comviva-springboot.md). |\n| `generate_test_cases` | Generate a JUnit 5 + Mockito test class for one Java class with `@DisplayName` on every test, `@Nested` groups per method, AssertJ assertions, and Comviva copyright header. For project-wide tests, the host LLM iterates over source files and calls this per class. |\n| `review_code` | Review a pull request / diff with severity-tagged findings anchored to file:line. |\n| `analyze_bug` | Root-cause a bug from symptoms, stack trace, logs, and source. |\n| `generate_rca` | Produce a publish-ready Root Cause Analysis report for an incident. |\n| `jira_get_issue` | Fetch a Jira issue. |\n| `jira_search_issues` | JQL search. |\n| `jira_create_issue` | File a new issue (bug, story, task, epic). |\n| `jira_update_issue` | Update fields on an issue. |\n| `jira_transition_issue` | Move an issue through workflow states. |\n| `jira_add_comment` | Attach investigation notes, RCA, or implementation updates. |\n| `jira_link_issues` | Link related issues (Blocks, Relates, Caused by, etc.). |\n| `jira_add_remote_link` | Attach a PR / deployment / dashboard URL to an issue. |\n| `recommend_architecture` | Propose a scalable system design for a goal. |\n| `review_architecture` | Review an API / database / microservice / pipeline / cloud infra design. |\n| `identify_tech_debt` | Inventory technical debt and produce a refactor roadmap. |\n| `review_cicd_pipeline` | Validate a CI/CD pipeline config. |\n| `review_infra_config` | Review Kubernetes / Docker / Terraform / Helm / CloudFormation. |\n| `deployment_readiness_check` | Pre-deploy go/no-go review with rollback and observability checks. |\n| `generate_documentation` | Tech design, API reference, runbook, README, or module overview. |\n| `generate_adr` | Architecture Decision Record (MADR style). |\n| `generate_implementation_plan` | Phased implementation plan with risks and definition of done. |\n| `generate_migration_strategy` | Migration strategy with stages, cutover, and rollback. |\n\n---\n\n## Install & build\n\n```bash\ncd D:/eclipse-workspace/MRTM_7.12/mrtm/codeforge-mcp\nnpm install\nnpm run build\n```\n\nThis produces `dist/index.js`.\n\n---\n\n## Configure environment\n\nJira tools require credentials. Copy `.env.example` to `.env` and fill in:\n\n```\nJIRA_HOST=https://your-company.atlassian.net\nJIRA_EMAIL=you@company.com\nJIRA_API_TOKEN=<API token from id.atlassian.com/manage-profile/security/api-tokens>\nJIRA_DEFAULT_PROJECT=MRTM\n```\n\n`.env` is **not** loaded automatically — pass these as real environment variables when the MCP client launches the server (see the next section). Tools that don't touch Jira work without these variables.\n\n---\n\n## Register with an MCP client\n\n### Claude Desktop\n\nEdit `%APPDATA%\\Claude\\claude_desktop_config.json` (Windows) and add:\n\n```json\n{\n  \"mcpServers\": {\n    \"codeforge\": {\n      \"command\": \"node\",\n      \"args\": [\"D:/eclipse-workspace/MRTM_7.12/mrtm/codeforge-mcp/dist/index.js\"],\n      \"env\": {\n        \"JIRA_HOST\": \"https://your-company.atlassian.net\",\n        \"JIRA_EMAIL\": \"you@company.com\",\n        \"JIRA_API_TOKEN\": \"<token>\",\n        \"JIRA_DEFAULT_PROJECT\": \"MRTM\"\n      }\n    }\n  }\n}\n```\n\nRestart Claude Desktop. The tools will appear in the tool picker.\n\n### Claude Code (CLI)\n\n```bash\nclaude mcp add codeforge node \"D:/eclipse-workspace/MRTM_7.12/mrtm/codeforge-mcp/dist/index.js\" \\\n  -e JIRA_HOST=https://your-company.atlassian.net \\\n  -e JIRA_EMAIL=you@company.com \\\n  -e JIRA_API_TOKEN=... \\\n  -e JIRA_DEFAULT_PROJECT=MRTM\n```\n\n### Cursor / VS Code (with MCP extension)\n\nAdd an entry in the client's MCP settings pointing to the same `node dist/index.js` command with the env vars above.\n\n---\n\n## Company standards (used by `scaffold_service`)\n\nThe conventions for new microservices live in [`standards/comviva-springboot.md`](standards/comviva-springboot.md) — packaging, copyright header, constructor injection, `@Slf4j` parameterized logging, Spring Kafka config pattern, Consul config layout, error handling, JPA, scheduling, Dockerfile. Edit that file to refine conventions; `scaffold_service` re-reads it on every call (no rebuild needed).\n\n### Example invocation from Claude\n\n> Scaffold a new service called `rewardservice` that consumes the `reward.events` Kafka topic, persists a `RewardLedger` entity to MySQL, and exposes `GET /rewards/{customerId}` to read balances.\n\nThe MCP client picks `scaffold_service`, fills in the args, and the host LLM produces the full project — pom.xml, `RewardserviceApplication.java`, `config/KafkaConfig.java`, `service/RewardEventConsumer.java`, `dao/RewardLedgerRepository.java`, `model/RewardLedger.java`, `controller/RewardController.java`, `application.yml`, `bootstrap.yml`, `consul-prop.yml`, `logback-spring.xml`, `Dockerfile`, and tests — all carrying the Comviva copyright header and following every rule in the standards file.\n\n---\n\n## How the prompt-only tools work\n\nWhen you call `review_code`, the server doesn't itself invoke an LLM. It returns a single text block containing:\n\n1. A senior-engineer **persona** prelude (role, tone, standards).\n2. The supplied inputs (the diff, PR title, etc.) embedded in a task description.\n3. A strict **output contract** — the exact sections, severity scale, table columns, and rules the LLM must follow.\n\nThe host LLM (Claude Desktop, Cursor, etc.) then executes that prompt as its next reasoning step. Because the contract is strict and the persona is consistent across tools, you get reproducible, high-quality output without standing up a second LLM endpoint.\n\nIf you later want the server to call an LLM itself (e.g. for batch jobs without a host UI), wire an Anthropic client into each tool's `handler` and post the existing prompt body to it. The current architecture is designed to make that swap trivial.\n\n---\n\n## Adding a new tool\n\n1. Create `src/tools/yourTool.ts` exporting a `ToolDefinition`:\n\n   ```ts\n   import { z } from \"zod\";\n   import { withPersona } from \"../prompts/persona.js\";\n   import type { ToolDefinition } from \"./types.js\";\n\n   const Schema = z.object({ /* inputs */ });\n\n   export const yourTool: ToolDefinition = {\n     name: \"your_tool\",\n     description: \"What it does, in one sentence.\",\n     inputSchema: Schema,\n     handler: async (raw) => {\n       const input = Schema.parse(raw);\n       return { content: [{ type: \"text\", text: withPersona(\"...prompt body...\") }] };\n     },\n   };\n   ```\n\n2. Register it in `src/tools/index.ts` under the right capability group.\n3. `npm run build`. The client picks up the new tool on next restart.\n\n---\n\n## Sharing with the team\n\nTwo distribution paths — start with **A**, promote to **B** once the standards stabilise.\n\n### A. Git clone\n\n**Maintainer (one-time):** push this folder to GitHub.\n\n**Each teammate (one-time):**\n\n```bash\ngit clone https://github.com/ThakurAnketPratapSingh/codeforge-mcp.git\ncd codeforge-mcp\nsetup.bat      # Windows\n./setup.sh     # macOS / Linux / Git Bash\n```\n\n`setup.bat` / `setup.sh` installs deps, builds, and runs `claude mcp add codeforge ...` automatically. Teammates add their own Jira creds afterwards (re-register with `-e JIRA_*` flags — see the setup script output).\n\n**Getting updates:**\n\n```bash\ngit pull && setup.bat\n```\n\nStandards live in [standards/comviva-springboot.md](standards/comviva-springboot.md), versioned with the repo, so `git pull` is how new conventions reach every teammate.\n\n### B. Public npm (npmjs.com)\n\nThe package is published to the public npm registry as `@anketpsingh/codeforge-mcp`. Anyone with Node.js installed can grab it — no token needed.\n\n> ⚠️ **Public publication means `standards/comviva-springboot.md` is searchable on npmjs.com.** Make sure that's intended.\n\n**Maintainer — one-time setup:**\n\n1. Create a free account at https://www.npmjs.com/signup\n2. Enable 2FA on the account (npm requires it for publishing).\n3. Authenticate on this machine:\n   ```bash\n   npm login\n   ```\n   Enter username, password, email, and the OTP from your authenticator.\n\n**Maintainer — each release:**\n\n```bash\nnpm run release:patch   # 0.1.0 → 0.1.1, builds, publishes\nnpm run release:minor   # 0.1.0 → 0.2.0\nnpm run release:major   # 0.1.0 → 1.0.0\n```\n\n`prepublishOnly` rebuilds from clean automatically. Only `dist/`, `standards/`, `README.md`, and `.env.example` ship.\n\n**Each teammate — one-time:**\n\n```bash\nnpm install -g @anketpsingh/codeforge-mcp\nclaude mcp add codeforge codeforge-mcp\n```\n\nNo `.npmrc` or token required — it's public.\n\n**Getting updates:**\n\n```bash\nnpm install -g @anketpsingh/codeforge-mcp@latest\n```\n\n### Per-user secrets (both paths)\n\nJira credentials are per-user. Each teammate adds their own via `claude mcp add ... -e JIRA_EMAIL=... -e JIRA_API_TOKEN=...` after the base install. Shared values (`JIRA_HOST`, `JIRA_DEFAULT_PROJECT`) go in the README so everyone copies them verbatim.\n\n### Evolving the standards\n\n`standards/comviva-springboot.md` is the single source of truth. To change a convention:\n\n1. Edit the file\n2. **Path A**: commit, push, teammates `git pull && setup.bat`\n3. **Path B**: bump version, `npm run release:minor`, teammates `npm install -g @anketpsingh/codeforge-mcp@latest`\n\nStandards changes are visible in `git log standards/` — useful when investigating \"why does the generator do X now\".\n\n---\n\n## Project layout\n\n```\ncodeforge-mcp/\n├── src/\n│   ├── index.ts              # stdio entry point\n│   ├── server.ts             # MCP server wiring\n│   ├── prompts/persona.ts    # shared senior-engineer persona\n│   ├── jira/client.ts        # Jira REST client (Cloud v3 / ADF)\n│   └── tools/\n│       ├── types.ts          # ToolDefinition shape, error helper\n│       ├── index.ts          # tool registry\n│       ├── codeGeneration.ts\n│       ├── codeReview.ts\n│       ├── bugAnalysis.ts\n│       ├── rca.ts\n│       ├── jira.ts\n│       ├── architecture.ts\n│       ├── devops.ts\n│       └── documentation.ts\n├── package.json\n├── tsconfig.json\n└── .env.example\n```\n","readmeFilename":"README.md"}