index.ts

#!/usr/bin/env node

import "reflect-metadata";

import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
import dotenv from "dotenv";

import { AlchemyApi } from "./api/alchemyApi.js";
import { registerTools } from "./api/registerTools.js";
import { setupDi } from "./di/di-container.js";
import { ClientsModule } from "./di/modules/clients.module.js";
import pkg from "./package.json" with { type: "json" };

dotenv.config();

// ========================================
// SERVER STARTUP
// ========================================

async function runServer() {
  const container = setupDi([new ClientsModule()]);
  const alchemyApi = container.get(AlchemyApi);

  const server = new McpServer({
    name: "alchemy-mcp-server",
    version: pkg.version,
    instructions:
      "Alchemy MCP Server provides access to blockchain data across EVM chains (Ethereum, Base, Polygon, Arbitrum, etc.) and Solana. " +
      "Use listSupportedNetworks to discover available chains. " +
      "For token prices use fetchTokenPrice* tools. For wallet balances use getTokenBalances or fetchTokensOwnedByMultichainAddresses. " +
      "For NFTs use getNFTs*/getOwnersFor*/getFloorPrice tools. For transaction history use fetchAddressTransactionHistory or fetchTransfers. " +
      "For transaction simulation use simulate* tools. For low-level debugging use debug*/trace* tools. " +
      "For Solana assets use solana* tools. For Beacon Chain data use getBeacon* tools. " +
      "Most tools accept a 'network' parameter — default is 'eth-mainnet'.",
  });

  registerTools(server, alchemyApi);

  const transport = new StdioServerTransport();
  try {
    await server.connect(transport);
    console.error("Alchemy MCP Server is running on stdio");
  } catch (error) {
    console.error("Error during server connection:", error);
    if (error instanceof Error) {
      console.error("Detailed error message:", error.message);
    }
    console.error(
      "Possible causes: network issues, incorrect configuration, or server not reachable.",
    );
    console.error("Consider checking the server logs and configuration.");
    process.exit(1);
  }
}

runServer().catch((error) => {
  console.error("Fatal error in runServer():", error);
  process.exit(1);
});