AetherTech MCP Server

A production-ready TypeScript MCP (Model Context Protocol) server with comprehensive tools and type safety.

Features

• Text Analysis Tools: Analyze, count words, detect sentiment, extract keywords
• Key-Value Store: In-memory storage for temporary data
• Resources: System info and dynamic store access
• Dual Transport: Support for both stdio and HTTP (Streamable HTTP)
• Type Safety: Full TypeScript with Zod validation
• Error Handling: Comprehensive try-catch with meaningful error messages

Installation

cd packages/mcp-server
npm install

Running the Server

Option 1: Stdio Transport (Default)

# Development mode
npm run dev:stdio

# Production mode
npm run start:stdio

Option 2: HTTP Transport

# Development mode
npm run dev:http

# Production mode
npm run start:http

# With custom port
PORT=8080 npm run start:http

The HTTP server runs at http://localhost:3000/mcp (or custom PORT).

Available Tools

text_analysis

Analyze text with various operations.

Input Schema:

{
  text: string;           // Required, 1-100000 chars
  operation: "analyze" | "word_count" | "sentiment" | "extract_keywords"
}

Example:

{
  "name": "text_analysis",
  "arguments": {
    "text": "This is an amazing product! I love it so much.",
    "operation": "sentiment"
  }
}

word_count

Count words in text with statistics.

Input Schema:

{
  text: string;
  includeWhitespace?: boolean;  // Default: false
}

key_value_store

In-memory key-value storage.

Input Schema:

{
  action: "get" | "set" | "delete" | "list";
  key?: string;
  value?: string;
}

Examples:

Set a value:

{
  "name": "key_value_store",
  "arguments": {
    "action": "set",
    "key": "user:1",
    "value": "John Doe"
  }
}

Get a value:

{
  "name": "key_value_store",
  "arguments": {
    "action": "get",
    "key": "user:1"
  }
}

List all:

{
  "name": "key_value_store",
  "arguments": {
    "action": "list"
  }
}

Testing with MCP Inspector

npm run inspector

For HTTP transport:

npx @modelcontextprotocol/inspector http://localhost:3000/mcp

Configuration

Environment Variable	Description	Default
PORT	HTTP server port	3000

Building

npm run build

Type Checking

npm run typecheck

Troubleshooting

Server won't start

• Ensure Node.js 18+ is installed: node --version
• Verify dependencies are installed: npm install

HTTP transport not connecting

• Check the port is not in use: lsof -i :3000
• Verify firewall settings
• Try a different port: PORT=8080 npm run start:http

Tools not working

• Run MCP Inspector to verify connection
• Check server logs for errors
• Ensure valid JSON is passed to tools