nieperdragon/custom_mcp

MCP Login Server

A Model Context Protocol (MCP) server that provides automated login functionality for http://localhost using predefined credentials. This server is designed to work with browser automation tools like the Playwright MCP server.

Features

• Automated Login: Provides tools to perform login operations with predefined credentials
• Playwright Integration: Designed to work with the Playwright MCP server for browser automation
• Connection Testing: Includes tools to test connectivity to the target URL
• Credential Management: Secure handling of login credentials
• Extensible Architecture: Easy to add new tools with separated tool definitions

Project Structure

src/
├── index.ts          # Main server setup and entry point
├── tools.ts          # Tool definitions and registration
└── index.js          # Compiled JavaScript (auto-generated)

The codebase is structured for easy extensibility:

• index.ts: Contains the main server setup, startup logic, and process management
• tools.ts: Contains all tool definitions, registration functions, and configuration
• ADDING_TOOLS.md: Detailed guide for adding new tools to the server

Installation

npm install
npm run build

Usage

Running the Server

npm start

Or for development:

npm run dev

Available Tools

The server provides the following MCP tools:

1. perform_login - Performs automated login to http://localhost using predefined credentials
2. get_login_credentials - Returns the login credentials for verification
3. test_connection - Tests if the target URL is accessible

Configuration

The server is configured with the following credentials:

• Target URL: http://localhost
• Username: admin
• Password: AIWorkshopJuly!25

These credentials are configured for the OrangeHRM system running on localhost.

MCP Configuration

To use this server with an MCP client (like Claude for Desktop), add the following configuration:

Windows

{
  "mcpServers": {
    "login-server": {
      "command": "node",
      "args": ["C:\\ABSOLUTE\\PATH\\TO\\PROJECT\\build\\index.js"]
    }
  }
}

macOS/Linux

{
  "mcpServers": {
    "login-server": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/TO/PROJECT/build/index.js"]
    }
  }
}

Integration with Playwright MCP Server

This server is designed to work alongside the Playwright MCP server for complete browser automation. The perform_login tool provides the necessary information and steps that can be executed by the Playwright MCP server.

Example Workflow

1. Use the test_connection tool to verify the target URL is accessible
2. Use the perform_login tool to get login instructions
3. Use Playwright MCP server tools to execute the browser automation steps

Development

Project Structure

src/
├── index.ts          # Main server implementation
├── types.ts          # TypeScript type definitions (if any)
build/                # Compiled JavaScript output
.github/              # GitHub configuration
├── copilot-instructions.md  # Copilot development guidelines

Building

npm run build

Scripts

• npm run build - Compile TypeScript to JavaScript
• npm start - Run the compiled server
• npm run dev - Build and run in development mode
• npm run clean - Clean build directory

Dependencies

• @modelcontextprotocol/sdk - MCP SDK for TypeScript
• zod - Runtime type validation
• typescript - TypeScript compiler

Error Handling

The server includes comprehensive error handling for:

• Connection failures
• Invalid credentials
• Network timeouts
• MCP protocol errors

Security

• Credentials are stored as constants in the code
• No sensitive data is logged to stdout (only to stderr for debugging)
• Connection testing uses safe HTTP HEAD requests

Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Test thoroughly
5. Submit a pull request

License

ISC License