Claude MCP Tools Quick Reference

Comprehensive guide to MCP tools, prompts, and resources for OpenForum integration

This reference provides detailed documentation for all available MCP (Model Context Protocol) tools, prompts, and resources in the HomeLab Claude environment. Each tool includes descriptions, parameters, usage examples, and integration patterns for seamless OpenForum development.

ClaudeTool

CLASSIFICATION: System Control Interface

FUNCTION: Initiate Claude Desktop restart sequence to reload MCP configurations

DESCRIPTION: This tool provides programmatic control over the Claude Desktop application lifecycle. When invoked, it triggers a clean restart of the Claude Desktop environment, which forces a reload of all MCP tool definitions, prompts, and resources from their registry files. This is essential after creating new tools, modifying existing ones, or updating configuration files like tool-list.json. The optional prompt parameter allows you to request user confirmation before the restart occurs.

ACCESS PROTOCOL: Request "restart" or "reload MCP tools" via voice command

PARAMETERS:

  • prompt (boolean) - Enable confirmation dialog before system restart
restart Claude Desktop
restart with confirmation prompt

MCPDevTool

CLASSIFICATION: Development Environment

FUNCTION: Create, test, and deploy new MCP tools within the system matrix

DESCRIPTION: A comprehensive development toolkit for building and managing MCP tools in the OpenForum environment. This meta-tool streamlines the entire development lifecycle by providing commands to create new tool files from templates, validate JavaScript syntax, register tools in the tool-list.json registry, and browse the tool directory structure. It eliminates manual file manipulation and reduces errors by automating the deployment process. The tool also provides direct access to read existing tool source code and restart Claude Desktop to test newly created or modified tools.

ACCESS PROTOCOL: Development workflow for MCP tool creation

AVAILABLE OPERATIONS:

  • create - Instantiate new tool from source code
  • test - Execute syntax validation protocols
  • deploy - Integration with tool-list.json registry
  • list - Display all available system tools
  • read - Access tool source code
  • restart - Reload Claude Desktop matrix
  • template - Retrieve tool construction template
  • listfiles - Browse directory matrix structures
create a new MCP tool for file processing
test the syntax of MyNewTool
deploy the DatabaseTool to the tool list

JavaTool

CLASSIFICATION: Code Compilation Matrix

FUNCTION: Compile and execute Java code, run Maven build protocols

DESCRIPTION: A full-featured Java development environment that bridges Claude AI with Java compilation and execution capabilities. This tool handles both standalone Java file compilation using javac and comprehensive Maven project management including building, testing, packaging, and executing Java applications. It manages classpaths, working directories, and command-line arguments automatically. Perfect for rapid prototyping, testing Java snippets, running Maven builds, executing test suites, and creating new Maven projects with specified group and artifact IDs. The tool captures both standard output and error streams to provide complete feedback on compilation and execution results.

ACCESS PROTOCOL: Java development and testing environment

AVAILABLE OPERATIONS:

  • compile_java - Compile .java source files
  • run_java - Execute compiled Java classes
  • compile_and_run - Combined compilation and execution
  • maven_compile - Maven compilation phase
  • maven_test - Execute Maven test suite
  • maven_package - Generate Maven package
  • maven_clean - Clean Maven project artifacts
  • maven_exec - Execute Java main class
  • create_maven_project - Initialize new Maven project
compile and run my HelloWorld.java file
run Maven tests on my project

Structured conversation initiators with expert guidance protocols for specific domains.

MCP Tool Developer

CLASSIFICATION: Development Assistant Protocol

FUNCTION: Expert guidance for MCP tool development

DESCRIPTION: An AI-powered expert assistant prompt that provides specialized guidance throughout the MCP tool development process. When activated, Claude assumes the role of an experienced MCP developer who can help design tool architectures, write clean JavaScript code for OpenForum integration, debug issues, suggest best practices, and explain MCP protocol specifications. This prompt is particularly valuable for understanding the nuances of tool parameter definitions, error handling patterns, and OpenForum helper class usage.

ACCESS PROTOCOL: "Use the MCP tool developer prompt to help me..."

PARAMETERS:

  • tool_type (optional) - Specify tool category
  • complexity (optional) - Define complexity level
  • specific_help (optional) - Target assistance area
use the MCP tool developer prompt to create a file processor

Java Code Reviewer

CLASSIFICATION: Code Analysis Protocol

FUNCTION: Expert Java code review and optimization recommendations

DESCRIPTION: A specialized code review prompt that transforms Claude into an expert Java code reviewer with deep knowledge of best practices, design patterns, performance optimization, and common pitfalls. When invoked, this prompt enables comprehensive analysis of Java code including style consistency, potential bugs, security vulnerabilities, performance bottlenecks, and architectural improvements. It can focus on specific aspects like thread safety, memory management, or Java version-specific features based on your requirements.

ACCESS PROTOCOL: "Use the Java code reviewer prompt to..."

PARAMETERS:

  • review_focus (optional) - Specify review focus area
  • code_complexity (optional) - Define code complexity level
  • java_version (optional) - Target Java version
use the Java code reviewer prompt for performance review

Data source access points, file systems, and system information repositories.

Tool Directory

URI: openforum://HomeLab/Claude/tools

CLASSIFICATION: File System Browser

FUNCTION: Browse MCP tool files and configuration matrices

DESCRIPTION: A dynamic resource that provides real-time inventory of all MCP tools in the system. When accessed, it scans the HomeLab/Claude directory for .sjs tool files, cross-references them with tool-list.json, and returns detailed metadata including file sizes, modification dates, registration status, and tool descriptions. This resource is invaluable for system auditing, discovering available tools, and identifying orphaned or unregistered tools that may need attention.

DATA FORMAT: JSON metadata with tool information, file statistics, and registry status

show me what MCP tools are available

System Logs

URI: openforum://system/logs

CLASSIFICATION: System Monitoring Interface

FUNCTION: Access system logs and MCP interaction history

DESCRIPTION: A comprehensive logging resource that aggregates system events, MCP tool invocations, error messages, and server activity into a readable format. It provides insight into what tools have been called, when they were executed, what errors occurred, and overall system health. Essential for troubleshooting tool failures, monitoring system performance, and understanding the flow of MCP communications between Claude and the OpenForum server.

DATA FORMAT: Server status reports, recent events, error summaries

check the system logs for any errors

Project Files

URI: openforum://projects/files

CLASSIFICATION: Project Analysis System

FUNCTION: Browse and analyze project files across development workspace

DESCRIPTION: A workspace analysis resource that scans configured project directories and generates comprehensive summaries including file counts, directory structures, programming language distributions, and project statistics. It helps Claude understand your project landscape without manually exploring the filesystem. Useful for project overviews, identifying codebases to work with, and getting quick insights into project composition and organization.

DATA FORMAT: Project summaries, file statistics, directory structures

show me what projects are available

Tool Development Workflow

create a new MCP tool for database queries
test the syntax of my DatabaseTool
add DatabaseTool to the tool list
restart Claude Desktop to load new tools

Java Development Workflow

  1. Write Java code in your development environment
  2. Execute: "compile my Java project"
  3. Execute: "run Maven tests"
  4. Use Java code reviewer prompt for guidance

System Monitoring Protocol

read the tool directory resource
check system logs for errors
list all available MCP tools

tool-list.json

CLASSIFICATION: Tool Registry Database

FUNCTION: Defines available MCP tools in the system matrix

{
  "toolName": {
    "pageName": "/HomeLab/Claude",
    "fileName": "ToolName.sjs"
  }
}

prompt-list.json

CLASSIFICATION: Prompt Registry Database

FUNCTION: Defines available MCP prompts in the system

{
  "promptName": {
    "pageName": "/HomeLab/Claude", 
    "fileName": "PromptName.sjs"
  }
}

resource-list.json

CLASSIFICATION: Resource Registry Database

FUNCTION: Defines available MCP resources in the system

{
  "resourceName": {
    "pageName": "/HomeLab/Claude",
    "fileName": "ResourceName.sjs"
  }
}

MCP Protocol

  • VERSION: 2024-11-05
  • TRANSPORT: OpenForum JavaScript server
  • CAPABILITIES: tools, prompts, resources (all with listChanged: true)

File System Locations

  • SERVER ROOT: /web/content/default/HomeLab/Claude/
  • TOOLS: *.sjs files + tool-list.json
  • PROMPTS: *Prompt.sjs files + prompt-list.json
  • RESOURCES: *Resource.sjs files + resource-list.json

OpenForum Integration

  • FILE HELPER: file.getFileAsString(), file.saveStringToFile()
  • JAVASCRIPT HELPER: js.getObject() for dynamic loading
  • PROCESS HELPER: Execute system commands
  • SERVER ROOT: All paths relative to /web/content/

Common System Errors

TOOL NOT FOUND: Verify tool-list.json and restart Claude Desktop

SYNTAX ERRORS: Use MCPDevTool test action to validate code

FILE PERMISSIONS: Ensure OpenForum has read/write access

JAVA COMPILATION: Check classpath and file path configurations

Debugging Procedures

  • LOGS: Read system logs resource for MCP activity analysis
  • TOOL STATUS: Use MCPDevTool list action for inventory
  • FILE BROWSER: Use MCPDevTool listfiles action for directory inspection
  • ERROR FILES: Check for error-*.json files in Claude directory

Tool Development Guidelines

  • Follow naming conventions (ToolName.sjs)
  • Include comprehensive error handling
  • Use OpenForum helper classes
  • Execute thorough testing before deployment
  • Document all parameters and usage patterns

Usage Optimization

  • Be specific in requests ("compile MyClass.java" vs "compile Java")
  • Use prompts for structured guidance protocols
  • Check resources for system status monitoring
  • Restart after configuration changes

Documentation Version: 1.0.0

MCP Server: OpenForum JavaScript Server

Last Updated: Generated dynamically from active tool registry

Support: For issues or questions, consult the MCP Tools Guide