home / mcp / mcp server framework

MCP Server Framework

Provides a general-purpose MCP server with echo, time, and file tools for Claude tools and desktop/code integrations.

Installation
Add the following to your MCP client configuration file.

Configuration

View docs
{
  "mcpServers": {
    "akkiotim-mcp-server": {
      "command": "python",
      "args": [
        "-m",
        "mcp_server.server"
      ],
      "env": {
        "PYTHONPATH": "/full/path/to/mcp-server/src",
        "MCP_LOG_LEVEL": "INFO",
        "MCP_SERVER_NAME": "mcp-server",
        "MCP_CUSTOM_VAR_*": "<MCP_CUSTOM_VAR_*>",
        "MCP_ALLOWED_PATHS": "/Users/you/Documents"
      }
    }
  }
}

Available tools

echo

Echo back a message

echo_uppercase

Echo in uppercase

echo_reverse

Echo reversed

get_current_time

Return current UTC time

get_timestamp

Return current Unix timestamp

parse_timestamp

Convert a timestamp to a human-readable format

time_difference

Calculate the difference between two timestamps

list_directory

List contents of a directory

read_file

Read file contents

get_file_info

Get file or directory metadata

get_allowed_paths

Show configured allowed paths