@h4shed/mcp-core

Core MCP server and skill registry for Fused Gaming.

This package provides:

• SkillRegistry: Dynamically loads and manages skill instances
• Type definitions: Standard interfaces for skills and tools
• Configuration management: Load/save .fused-gaming-mcp.json config
• MCP Server: Stdio-based MCP server with skill tool registration

Installation

npm install @h4shed/mcp-core

Usage

As a library

import { SkillRegistry } from "@h4shed/mcp-core";

const registry = new SkillRegistry();
const skill = await registry.loadSkill("algorithmic-art");
console.log(skill?.tools);

As an MCP server

See parent package @h4shed/mcp for instructions.

API Reference

SkillRegistry

class SkillRegistry {
  loadSkill(name: string, config?: SkillConfig): Promise<Skill | null>;
  registerSkill(skill: Skill): void;
  getSkill(name: string): Skill | undefined;
  listSkills(): string[];
  unloadSkill(name: string): Promise<void>;
  unloadAll(): Promise<void>;
}

Types

interface Skill {
  name: string;
  version: string;
  description: string;
  tools: ToolDefinition[];
  initialize(config: SkillConfig): Promise<void>;
  cleanup?(): Promise<void>;
}

interface ToolDefinition {
  name: string;
  description: string;
  inputSchema: ToolInputSchema;
  handler(input: Record<string, unknown>): Promise<string | Record<string, unknown>>;
}

See src/types.ts for complete type definitions.

Development

# from repository root
npm run build --workspace=packages/core
npm run test --workspace=packages/core

License

Apache-2.0