fix: following standard naming, fixed SSE server

Author: wayzeek

README.md

@@ -5,7 +5,7 @@
 ![TypeScript](https://img.shields.io/badge/TypeScript-5.0+-3178C6)
 ![Viem](https://img.shields.io/badge/Viem-1.0+-green)
 
-A comprehensive Model Context Protocol (MCP) server that provides blockchain operations across multiple EVM-compatible networks. This server enables AI agents to interact with Ethereum, Optimism, Arbitrum, Base, Polygon, and many other EVM chains with a unified interface.
+A comprehensive Model Context Protocol (MCP) server that provides blockchain services across multiple EVM-compatible networks. This server enables AI agents to interact with Ethereum, Optimism, Arbitrum, Base, Polygon, and many other EVM chains with a unified interface.
 
 ## 📋 Contents
 
@@ -26,16 +26,16 @@ A comprehensive Model Context Protocol (MCP) server that provides blockchain ope
 
 ## 🔭 Overview
 
-The MCP EVM Server leverages the Model Context Protocol to provide blockchain operations to AI agents. It supports a wide range of operations including:
+The MCP EVM Server leverages the Model Context Protocol to provide blockchain services to AI agents. It supports a wide range of services including:
 
 - Reading blockchain state (balances, transactions, blocks, etc.)
 - Interacting with smart contracts
 - Transferring tokens (native, ERC20, ERC721, ERC1155)
 - Querying token metadata and balances
-- Chain-specific operations across 30+ EVM networks
+- Chain-specific services across 30+ EVM networks
 - **ENS name resolution** for all address parameters (use human-readable names like 'vitalik.eth' instead of addresses)
 
-All operations are exposed through a consistent interface of MCP tools and resources, making it easy for AI agents to discover and use blockchain functionality. **Every tool that accepts Ethereum addresses also supports ENS names**, automatically resolving them to addresses behind the scenes.
+All services are exposed through a consistent interface of MCP tools and resources, making it easy for AI agents to discover and use blockchain functionality. **Every tool that accepts Ethereum addresses also supports ENS names**, automatically resolving them to addresses behind the scenes.
 
 ## ✨ Features
 
@@ -48,7 +48,7 @@ All operations are exposed through a consistent interface of MCP tools and resou
 - **Address balances** for native tokens and all token standards
 - **ENS resolution** for human-readable Ethereum addresses (use 'vitalik.eth' instead of '0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045')
 
-### Token Operations
+### Token services
 
 - **ERC20 Tokens**
   - Get token metadata (name, symbol, decimals, supply)
@@ -70,7 +70,7 @@ All operations are exposed through a consistent interface of MCP tools and resou
 ### Smart Contract Interactions
 
 - **Read contract state** through view/pure functions
-- **Write operations** with private key signing
+- **Write services** with private key signing
 - **Contract verification** to distinguish from EOAs
 - **Event logs** retrieval and filtering
 
@@ -279,7 +279,7 @@ console.log(result);
 
 The server provides the following MCP tools for agents. **All tools that accept address parameters support both Ethereum addresses and ENS names.**
 
-#### Token Operations
+#### Token services
 
 | Tool Name | Description | Key Parameters |
 |-----------|-------------|----------------|
@@ -295,7 +295,7 @@ The server provides the following MCP tools for agents. **All tools that accept
 | `get-erc1155-balance` | Check ERC1155 balance | `tokenAddress` (address/ENS), `tokenId`, `ownerAddress` (address/ENS), `network` |
 | `transfer-erc1155` | Transfer ERC1155 tokens | `privateKey`, `tokenAddress` (address/ENS), `tokenId`, `amount`, `toAddress` (address/ENS), `network` |
 
-#### Blockchain Operations
+#### Blockchain services
 
 | Tool Name | Description | Key Parameters |
 |-----------|-------------|----------------|
@@ -341,7 +341,7 @@ The server exposes blockchain data through the following MCP resource URIs. All
 - Consider implementing additional authentication mechanisms for production use
 - Use HTTPS for the HTTP server in production environments
 - Implement rate limiting to prevent abuse
-- For high-value operations, consider adding confirmation steps
+- For high-value services, consider adding confirmation steps
 
 ## 📁 Project Structure
 
@@ -357,15 +357,15 @@ mcp-evm-server/
 │   │   ├── resources.ts        # MCP resources implementation
 │   │   ├── tools.ts            # MCP tools implementation
 │   │   ├── prompts.ts          # MCP prompts implementation
-│   │   └── operations/         # Core blockchain operations
+│   │   └── services/           # Core blockchain services
 │   │       ├── index.ts        # Operation exports
-│   │       ├── balance.ts      # Balance operations
-│   │       ├── transfer.ts     # Token transfer operations
+│   │       ├── balance.ts      # Balance services
+│   │       ├── transfer.ts     # Token transfer services
 │   │       ├── utils.ts        # Utility functions
-│   │       ├── tokens.ts       # Token metadata operations
+│   │       ├── tokens.ts       # Token metadata services
 │   │       ├── contracts.ts    # Contract interactions
-│   │       ├── transactions.ts # Transaction operations
-│   │       └── blocks.ts       # Block operations
+│   │       ├── transactions.ts # Transaction services
+│   │       └── blocks.ts       # Block services
 │   │       └── clients.ts      # RPC client utilities
 ├── package.json
 ├── tsconfig.json
@@ -376,7 +376,7 @@ mcp-evm-server/
 
 To modify or extend the server:
 
-1. Add new operations in the appropriate file under `src/core/operations/`
+1. Add new services in the appropriate file under `src/core/services/`
 2. Register new tools in `src/core/tools.ts`
 3. Register new resources in `src/core/resources.ts`
 4. Add new network support in `src/core/chains.ts`

src/core/resources.ts

@@ -1,6 +1,6 @@
 import { McpServer, ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { getSupportedNetworks, getRpcUrl } from "./chains.js";
-import * as operations from "./operations/index.js";
+import * as services from "./services/index.js";
 import type { Address, Hash } from "viem";
 
 /**
@@ -15,8 +15,8 @@ export function registerEVMResources(server: McpServer) {
     async (uri, params) => {
       try {
         const network = params.network as string;
-        const chainId = await operations.getChainId(network);
-        const blockNumber = await operations.getBlockNumber(network);
+        const chainId = await services.getChainId(network);
+        const blockNumber = await services.getBlockNumber(network);
         const rpcUrl = getRpcUrl(network);
 
         return {
@@ -48,8 +48,8 @@ export function registerEVMResources(server: McpServer) {
     async (uri) => {
       try {
         const network = "ethereum";
-        const chainId = await operations.getChainId(network);
-        const blockNumber = await operations.getBlockNumber(network);
+        const chainId = await services.getChainId(network);
+        const blockNumber = await services.getBlockNumber(network);
         const rpcUrl = getRpcUrl(network);
 
         return {
@@ -82,12 +82,12 @@ export function registerEVMResources(server: McpServer) {
       try {
         const network = params.network as string;
         const blockNumber = params.blockNumber as string;
-        const block = await operations.getBlockByNumber(parseInt(blockNumber), network);
+        const block = await services.getBlockByNumber(parseInt(blockNumber), network);
 
         return {
           contents: [{
             uri: uri.href,
-            text: operations.helpers.formatJson(block)
+            text: services.helpers.formatJson(block)
           }]
         };
       } catch (error) {
@@ -109,12 +109,12 @@ export function registerEVMResources(server: McpServer) {
       try {
         const network = params.network as string;
         const blockHash = params.blockHash as string;
-        const block = await operations.getBlockByHash(blockHash as Hash, network);
+        const block = await services.getBlockByHash(blockHash as Hash, network);
 
         return {
           contents: [{
             uri: uri.href,
-            text: operations.helpers.formatJson(block)
+            text: services.helpers.formatJson(block)
           }]
         };
       } catch (error) {
@@ -135,12 +135,12 @@ export function registerEVMResources(server: McpServer) {
     async (uri, params) => {
       try {
         const network = params.network as string;
-        const block = await operations.getLatestBlock(network);
+        const block = await services.getLatestBlock(network);
 
         return {
           contents: [{
             uri: uri.href,
-            text: operations.helpers.formatJson(block)
+            text: services.helpers.formatJson(block)
           }]
         };
       } catch (error) {
@@ -161,12 +161,12 @@ export function registerEVMResources(server: McpServer) {
     async (uri) => {
       try {
         const network = "ethereum";
-        const block = await operations.getLatestBlock(network);
+        const block = await services.getLatestBlock(network);
 
         return {
           contents: [{
             uri: uri.href,
-            text: operations.helpers.formatJson(block)
+            text: services.helpers.formatJson(block)
           }]
         };
       } catch (error) {
@@ -188,7 +188,7 @@ export function registerEVMResources(server: McpServer) {
       try {
         const network = params.network as string;
         const address = params.address as string;
-        const balance = await operations.getETHBalance(address as Address, network);
+        const balance = await services.getETHBalance(address as Address, network);
 
         return {
           contents: [{
@@ -222,7 +222,7 @@ export function registerEVMResources(server: McpServer) {
       try {
         const network = "ethereum";
         const address = params.address as string;
-        const balance = await operations.getETHBalance(address as Address, network);
+        const balance = await services.getETHBalance(address as Address, network);
 
         return {
           contents: [{
@@ -258,7 +258,7 @@ export function registerEVMResources(server: McpServer) {
         const address = params.address as string;
         const tokenAddress = params.tokenAddress as string;
 
-        const balance = await operations.getERC20Balance(
+        const balance = await services.getERC20Balance(
           tokenAddress as Address,
           address as Address,
           network
@@ -300,7 +300,7 @@ export function registerEVMResources(server: McpServer) {
         const address = params.address as string;
         const tokenAddress = params.tokenAddress as string;
 
-        const balance = await operations.getERC20Balance(
+        const balance = await services.getERC20Balance(
           tokenAddress as Address,
           address as Address,
           network
@@ -340,12 +340,12 @@ export function registerEVMResources(server: McpServer) {
       try {
         const network = params.network as string;
         const txHash = params.txHash as string;
-        const tx = await operations.getTransaction(txHash as Hash, network);
+        const tx = await services.getTransaction(txHash as Hash, network);
 
         return {
           contents: [{
             uri: uri.href,
-            text: operations.helpers.formatJson(tx)
+            text: services.helpers.formatJson(tx)
           }]
         };
       } catch (error) {
@@ -367,12 +367,12 @@ export function registerEVMResources(server: McpServer) {
       try {
         const network = "ethereum";
         const txHash = params.txHash as string;
-        const tx = await operations.getTransaction(txHash as Hash, network);
+        const tx = await services.getTransaction(txHash as Hash, network);
 
         return {
           contents: [{
             uri: uri.href,
-            text: operations.helpers.formatJson(tx)
+            text: services.helpers.formatJson(tx)
           }]
         };
       } catch (error) {
@@ -422,7 +422,7 @@ export function registerEVMResources(server: McpServer) {
         const network = params.network as string;
         const tokenAddress = params.tokenAddress as Address;
 
-        const tokenInfo = await operations.getERC20TokenInfo(tokenAddress, network);
+        const tokenInfo = await services.getERC20TokenInfo(tokenAddress, network);
 
         return {
           contents: [{
@@ -455,7 +455,7 @@ export function registerEVMResources(server: McpServer) {
         const tokenAddress = params.tokenAddress as Address;
         const address = params.address as Address;
 
-        const balance = await operations.getERC20Balance(tokenAddress, address, network);
+        const balance = await services.getERC20Balance(tokenAddress, address, network);
 
         return {
           contents: [{
@@ -492,12 +492,12 @@ export function registerEVMResources(server: McpServer) {
         const tokenAddress = params.tokenAddress as Address;
         const tokenId = BigInt(params.tokenId as string);
 
-        const nftInfo = await operations.getERC721TokenMetadata(tokenAddress, tokenId, network);
+        const nftInfo = await services.getERC721TokenMetadata(tokenAddress, tokenId, network);
 
         // Get owner separately
         let owner = "Unknown";
         try {
-          const isOwner = await operations.isNFTOwner(tokenAddress, params.address as Address, tokenId, network);
+          const isOwner = await services.isNFTOwner(tokenAddress, params.address as Address, tokenId, network);
           if (isOwner) {
             owner = params.address as string;
           }
@@ -539,7 +539,7 @@ export function registerEVMResources(server: McpServer) {
         const tokenId = BigInt(params.tokenId as string);
         const address = params.address as Address;
 
-        const isOwner = await operations.isNFTOwner(tokenAddress, address, tokenId, network);
+        const isOwner = await services.isNFTOwner(tokenAddress, address, tokenId, network);
 
         return {
           contents: [{
@@ -574,7 +574,7 @@ export function registerEVMResources(server: McpServer) {
         const tokenAddress = params.tokenAddress as Address;
         const tokenId = BigInt(params.tokenId as string);
 
-        const tokenURI = await operations.getERC1155TokenURI(tokenAddress, tokenId, network);
+        const tokenURI = await services.getERC1155TokenURI(tokenAddress, tokenId, network);
 
         return {
           contents: [{
@@ -609,7 +609,7 @@ export function registerEVMResources(server: McpServer) {
         const tokenId = BigInt(params.tokenId as string);
         const address = params.address as Address;
 
-        const balance = await operations.getERC1155Balance(tokenAddress, address, tokenId, network);
+        const balance = await services.getERC1155Balance(tokenAddress, address, tokenId, network);
 
         return {
           contents: [{

src/core/operations/balance.ts src/core/services/balance.ts

@@ -1,4 +1,4 @@
-// Export all operations
+// Export all services
 export * from './clients.js';
 export * from './balance.js';
 export * from './transfer.js';