Files
Jonathan Miller b73c1eba25
Generic: Repo Health / Scripts governance (push) Has been cancelled
Generic: Repo Health / Repository health (push) Has been cancelled
Generic: Repo Health / Report Issues (push) Has been cancelled
Generic: Project CI / Tests (pull_request) Has been cancelled
Platform: mokoplatform CI / Gate 2: Unit Tests (8.1) (pull_request) Has been cancelled
Platform: mokoplatform CI / Gate 2: Unit Tests (8.2) (pull_request) Has been cancelled
Platform: mokoplatform CI / Gate 2: Unit Tests (8.3) (pull_request) Has been cancelled
Platform: mokoplatform CI / Gate 3: Self-Health Check (pull_request) Has been cancelled
Platform: mokoplatform CI / Gate 4: Governance (pull_request) Has been cancelled
Platform: mokoplatform CI / Gate 5: Template Integrity (pull_request) Has been cancelled
Platform: mokoplatform 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 Issues (pull_request) Has been cancelled
Generic: Repo Health / Site Health (push) Has been cancelled
Generic: Repo Health / Access control (push) Has been cancelled
Generic: Repo Health / Site Health (pull_request) Has been cancelled
Universal: PR Check / Branch Policy (pull_request) Has been cancelled
Generic: Repo Health / Access control (pull_request) Has been cancelled
Universal: Build & Release / Promote to RC (pull_request) Has been cancelled
RC Revert / Rename rc/ back to dev/ (pull_request) Has been cancelled
Universal: Security Audit / Dependency Audit (pull_request) Has been cancelled
Branch Cleanup / Delete merged branch (pull_request) Has been cancelled
Universal: Secret Scanning / Gitleaks Secret Scan (pull_request) Has been cancelled
Universal: PR Check / Validate PR (pull_request) Has been cancelled
Universal: Build & Release / Build & Release Pipeline (pull_request) Has been cancelled
Generic: Project CI / Lint & Validate (pull_request) Has been cancelled
Platform: mokoplatform CI / Gate 1: Code Quality (pull_request) Has been cancelled
feat: add manifest_detect.php CLI tool for auto-detecting manifest fields
Scans source files to detect platform, name, version, element_name,
package_type, language, entry_point, description, and license_spdx.
Supports Joomla, Dolibarr, Go, MCP/Node, and generic platforms.

Includes --diff and --update modes for comparing against and pushing
to the Gitea manifest API. Warns on missing core fields.

Also removes deprecated mcp/servers/mokowaas_api (consolidated to
separate repo) and syncs dev branch changes.
2026-06-07 15:37:24 -05:00
..
2026-06-06 11:49:30 -05:00

Template-MCP

Language License Platform Wiki

Template repository for creating MokoStandards-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.json pattern for managing multiple named API connections with a default fallback; all tools accept an optional connection parameter
  • 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, and lint targets; npm scripts for compilation and development
  • MokoStandards compliant -- follows all Moko Consulting governance conventions: file headers, commit messages, .gitattributes, .gitmessage, PR/issue templates
  • Example configuration -- config.example.json demonstrates the connection configuration schema
  • Documentation templates -- wiki pages for API reference, architecture overview, and installation pre-generated

Installation

  1. 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
    
  2. Install dependencies:
    npm install
    
  3. Copy and configure the connection file:
    cp config.example.json config.json
    # Edit config.json with your API credentials
    
  4. Build the project:
    npm run build
    
  5. 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.


Moko Consulting -- MokoStandards