Use this page when you are contributing to coding-mcp itself. For normal usage, agents can work remotely through MCP without cloning target repositories to the agent machine. Clone the source code: 
git clone https://github.com/kieutrongthien/coding-mcp.git
cd coding-mcp && npm install

​
Configure environment

Create a local env file from the example: 
cp .env.example .env
Set project roots in .env: 
PROJECTS_ROOTS=/projects,/srv/repos

​
Local workflow

Use this loop for feature development:
1

Install dependencies

npm install
2

Run quality gates

npm run typecheck
npm test
3

Run the server locally

npm run dev:serve -- --transport http --host 127.0.0.1 --port 3001 --mode streamable

​
Build targets

  • npm run build compiles TypeScript into dist/
  • npm run start:serve runs the production CLI entry
  • npm run start:http and npm run start:stdio run transport-specific entrypoints

​
Documentation workflow

Docs are maintained in the docs/ directory with Mintlify. 
cd docs
mint validate
Optional checks: 
mint broken-links

​
Test strategy

The test suite includes:
  • Unit tests for core safety and service logic
  • Integration tests for transport boot and registry workflows
  • Patch and filesystem behavior tests, including binary-safe reads
When you add behavior, update tests in the matching module area under test/.

​
Contribution checklist

  • Keep zod schemas and handlers in sync
  • Preserve response envelope structure
  • Keep destructive operations guarded
  • Update docs and .env.example for user-facing changes