MCP 服务器

Hostname MCP Server

Enables AI assistants to automatically identify which machine they're working with by providing hostname detection and system information including CPU, memory, OS version, and architecture.

README

Hostname MCP Server

A lightweight Model Context Protocol (MCP) server focused on hostname detection with system information. Perfect for AI assistants to automatically identify which machine they're working with.

Generated by Claude Sonnet 4, directed by leependu.

Features

🔒 Secure: Only reads system information, never executes arbitrary commands
🏷️ Focused: Hostname detection first, system specs second
⚡ Lightweight: Minimal dependencies and fast startup
🎯 Purpose-built: Designed specifically for Claude Desktop workflow optimization

Tools Provided

`get_hostname`

Returns just the system hostname - perfect for quick machine identification.

`get_system_info`

Comprehensive system information including:

Hostname and platform details
CPU count and memory information
OS version and architecture
System uptime
User information

Installation

Install dependencies:

npm install

Build the TypeScript:

npm run build

Test the server:

npm start

Usage with Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "hostname": {
      "command": "node",
      "args": [
        "/path/to/hostname-mcp/build/index.js"
      ]
    }
  }
}

Development

npm run build - Build TypeScript to JavaScript
npm run dev - Watch mode for development
npm start - Run the built server

Security

This server is designed to be secure by default:

Only reads system information using Node.js os module
No arbitrary command execution
No environment variable exposure
No sensitive data access

Version 2.0 Changes

Removed get_environment_context: Eliminated potential security risk of exposing environment variables
Removed get_quick_summary: Redundant information already available in other tools
Focused approach: Now provides just hostname and system info - clean and secure

Project Context

Created as part of a workflow optimization to automatically identify which machine Claude is working with, eliminating the need to manually specify the computer at the start of each conversation.

Perfect for users with multiple development machines who want streamlined AI assistance.