Public Access
jmiller
3f956f5661
Universal: PR Check / Branch Policy (pull_request) Successful in 2s
Generic: Repo Health / Access control (pull_request) Successful in 2s
Generic: Repo Health / Site Health (pull_request) Has been skipped
Universal: PR Check / Validate PR (pull_request) Successful in 9s
Universal: PR Check / Secret Scan (pull_request) Successful in 11s
Universal: Pre-Release / Build Pre-Release (${{ inputs.stability || github.ref_name }}) (push) Successful in 18s
Generic: Project CI / Lint & Validate (pull_request) Successful in 1m6s
Platform: mokocli CI / Gate 1: Code Quality (pull_request) Failing after 1m17s
Universal: Build & Release / Promote to RC (pull_request) Has been skipped
RC Revert / Rename rc/ back to dev/ (pull_request) Has been skipped
Branch Cleanup / Delete merged branch (pull_request) Failing after 2s
Universal: Build & Release / Build & Release Pipeline (pull_request) Successful in 22s
Universal: Workflow Sync Trigger / Sync workflows to live repos (pull_request) Successful in 6m14s
Generic: Project CI / Tests (pull_request) Has been cancelled
Platform: mokocli CI / Gate 2: Unit Tests (8.1) (pull_request) Has been cancelled
Platform: mokocli CI / Gate 2: Unit Tests (8.2) (pull_request) Has been cancelled
Platform: mokocli CI / Gate 2: Unit Tests (8.3) (pull_request) Has been cancelled
Platform: mokocli CI / Gate 3: Self-Health Check (pull_request) Has been cancelled
Platform: mokocli CI / Gate 4: Governance (pull_request) Has been cancelled
Platform: mokocli CI / Gate 5: Template Integrity (pull_request) Has been cancelled
Platform: mokocli CI / CI Summary (pull_request) Has been cancelled
Universal: PR Check / Build RC Package (pull_request) Has been cancelled
Universal: PR Check / Report Issues (pull_request) Has been cancelled
Generic: Repo Health / Scripts governance (pull_request) Has been cancelled
Generic: Repo Health / Repository health (pull_request) Has been cancelled
Generic: Repo Health / Report: Scripts Governance (pull_request) Has been cancelled
Generic: Repo Health / Report: Repository Health (pull_request) Has been cancelled
The automation/ directory was removed (bulk_sync.php moved to wrappers/, others deleted) but references remained, hard-failing Gate 1 phpcs and the post-merge sync. Drop automation/ from phpcs/phpstan config and repoint sync-on-merge to wrappers/bulk_sync.php. Also remove the dangling mcp/servers/mokogitea_api and mcp/servers/windows/mcp_windows gitlinks that had no .gitmodules entry and broke submodule init at checkout.
Template-MCP
Template repository for creating MokoCli-compliant Model Context Protocol (MCP) API servers. Provides the scaffolding, configuration patterns, and architecture conventions used by all Moko Consulting MCP servers, enabling AI assistants like Claude to interact with REST APIs through a standardized tool interface.
Features
- MCP server scaffolding -- pre-configured TypeScript project structure with entry point, tool registration, and stdio transport ready to go
- Multi-connection support -- built-in
config.jsonpattern for managing multiple named API connections with a default fallback; all tools accept an optionalconnectionparameter - REST API bridge architecture -- standardized pattern for bridging any REST API as MCP tools, with typed request/response handling
- TypeScript-first -- full TypeScript setup with
tsconfig.json, strict mode, and ES module output - Build tooling -- Makefile with
build,dev,clean, andlinttargets; npm scripts for compilation and development - MokoCli compliant -- follows all Moko Consulting governance conventions: file headers, commit messages,
.gitattributes,.gitmessage, PR/issue templates - Example configuration --
config.example.jsondemonstrates the connection configuration schema - Documentation templates -- wiki pages for API reference, architecture overview, and installation pre-generated
Installation
- Create a new repository from this template (or clone directly):
git clone https://git.mokoconsulting.tech/MokoConsulting/Template-MCP.git my-mcp-server cd my-mcp-server - Install dependencies:
npm install - Copy and configure the connection file:
cp config.example.json config.json # Edit config.json with your API credentials - Build the project:
npm run build - Run the server:
node build/index.js
Configuration
| Path | Purpose |
|---|---|
src/ |
TypeScript source files (server entry, tool definitions, API client) |
config.example.json |
Example multi-connection configuration schema |
config.json |
Local connection configuration (gitignored) |
package.json |
npm dependencies and scripts |
tsconfig.json |
TypeScript compiler configuration |
scripts/ |
Build and development utility scripts |
docs/ |
Developer documentation |
Makefile |
Build, dev, clean, and lint targets |
Requirements
- Node.js 20.0.0 or later
- npm 9+
- TypeScript 5+ (installed via npm)
Documentation
Full documentation is available on the Wiki, including:
- API -- tool reference and connection parameter documentation
- ARCHITECTURE -- MCP server design and REST API bridge pattern
- INSTALLATION -- setup prerequisites and configuration guide
Contributing
See the wiki for development guidelines and contribution instructions.
License
This project is licensed under the GNU General Public License v3.0 or later -- see the LICENSE file.