zhin-mcp-server

Original：🇺🇸 English

Translated

Guides setup and usage of the Zhin MCP (Model Context Protocol) server plugin. Covers configuration, available tools, resources, and prompts for AI assistant integration. Use when integrating Zhin with AI coding assistants like Claude or Cursor via MCP.

1installs

Sourcezhinjs/ai-skills

Added on2026-02-11

NPX Install

npx skill4agent add zhinjs/ai-skills zhin-mcp-server

SKILL.md Content

View Translation Comparison →

Zhin MCP Server Guide

Use this skill to set up the

@zhin.js/mcp

plugin, enabling AI assistants (Claude, Cursor, etc.) to understand and generate Zhin plugins via the Model Context Protocol.

Installation

bash

pnpm add @zhin.js/mcp

Configuration

MCP requires the HTTP plugin. Enable both in

zhin.config.yml

:

yaml

plugins:
  - http
  - mcp

http:
  port: 8086

mcp:
  enabled: true
  path: /mcp

The MCP endpoint is available at

http://localhost:8086/mcp

.

Connecting AI Assistants

Claude Desktop

Edit

~/Library/Application Support/Claude/claude_desktop_config.json

:

json

{
  "mcpServers": {
    "zhin": {
      "command": "curl",
      "args": ["-N", "http://localhost:8086/mcp"]
    }
  }
}

Cursor/VSCode

Install an MCP extension and configure the server URL in settings.

Available Tools

create_plugin

Create a new Zhin plugin file.

Parameter	Required	Description
`name`	Yes	Plugin name
`description`	Yes	Plugin description
`features`	No	Feature list: `command` , `middleware` , `component` , `context` , `database`
`directory`	No	Save directory (default: `src/plugins` )

create_command

Generate command code snippets.

Parameter	Required	Description
`pattern`	Yes	Command pattern, e.g. `hello <name:text>`
`description`	Yes	Command description
`hasPermission`	No	Whether to include permission checks

create_component

Generate message component code.

Parameter	Required	Description
`name`	Yes	Component name
`props`	Yes	Property definitions
`usesJsx`	No	Whether to use JSX syntax

create_adapter

Generate platform adapter code.

Parameter	Required	Description
`name`	Yes	Adapter name
`description`	Yes	Adapter description
`hasWebhook`	No	Whether webhook support is needed

create_model

Generate database model definition.

Parameter	Required	Description
`name`	Yes	Model name
`fields`	Yes	Field definitions

query_plugin

Query details of an existing plugin.

Parameter	Required	Description
`pluginName`	Yes	Plugin name to query

list_plugins

List all loaded plugins (no parameters).

Available Resources

MCP exposes documentation as resources:

URI	Description
`zhin://docs/architecture`	Zhin architecture design
`zhin://docs/plugin-development`	Plugin development guide
`zhin://docs/best-practices`	Development best practices
`zhin://docs/command-system`	Command system docs
`zhin://docs/component-system`	Component system docs
`zhin://docs/context-system`	Context system docs
`zhin://examples/basic-plugin`	Basic plugin example
`zhin://examples/command-plugin`	Command plugin example
`zhin://examples/adapter`	Adapter example

Available Prompts

create-plugin-workflow

Guides the full plugin creation workflow.

Parameter:

feature_type

—

command

,

middleware

,

component

, or

adapter

.

debug-plugin

Step-by-step plugin debugging guidance.