@mcp-shark/mcp-shark 1.4.1 → 1.5.0

package/mcp-server/.editorconfig

@@ -1,15 +0,0 @@
-root = true
-
-[*]
-charset = utf-8
-end_of_line = lf
-insert_final_newline = true
-trim_trailing_whitespace = true
-
-[*.{js,jsx,ts,tsx,json,css,md}]
-indent_style = space
-indent_size = 2
-
-[*.md]
-trim_trailing_whitespace = false
-

package/mcp-server/.prettierignore

@@ -1,11 +0,0 @@
-node_modules
-dist
-build
-coverage
-*.min.js
-.git
-.husky
-package-lock.json
-yarn.lock
-pnpm-lock.yaml
-

package/mcp-server/.prettierrc

@@ -1,12 +0,0 @@
-{
-  "semi": true,
-  "trailingComma": "es5",
-  "singleQuote": true,
-  "printWidth": 80,
-  "tabWidth": 2,
-  "useTabs": false,
-  "arrowParens": "avoid",
-  "endOfLine": "lf",
-  "bracketSpacing": true
-}
-

package/mcp-server/README.md

@@ -1,280 +0,0 @@
-# MCP Shark Server
-
-> **Aggregate multiple Model Context Protocol (MCP) servers into a single unified interface**
-
-MCP Shark Server is a powerful aggregation layer that combines multiple MCP servers (both HTTP and stdio-based) into one cohesive endpoint. It provides a unified API for tools, prompts, and resources from all connected servers, with comprehensive audit logging and session management.
-
-## ✨ Features
-
-- **🔗 Multi-Server Aggregation**: Connect to multiple MCP servers simultaneously (HTTP and stdio)
-- **📊 Comprehensive Audit Logging**: SQLite-based logging with request/response tracking, performance metrics, and error handling
-- **🌐 HTTP Interface**: RESTful API endpoint for easy integration with any MCP client
-- **🔄 Session Management**: Automatic session handling for stateful MCP interactions
-- **🛠️ Unified Tool Access**: Access tools from all connected servers through a single interface
-- **📝 Prompt & Resource Aggregation**: Unified access to prompts and resources across all servers
-- **⚡ Streaming Support**: Full support for async iterable responses (streaming)
-- **🔍 Request Correlation**: Track request/response pairs with correlation IDs
-
-## 🚀 Quick Start
-
-### Installation
-
-```bash
-npm install
-```
-
-### Configuration
-
-**Recommended: Use the UI**
-
-The recommended way to configure the MCP server is through the UI interface, which automatically detects and converts IDE configuration files.
-
-**Alternative: Manual Configuration**
-
-If running the server directly, create a configuration file at `~/.mcp-shark/mcps.json`:
-
-```json
-{
-  "servers": {
-    "github": {
-      "type": "http",
-      "url": "https://api.githubcopilot.com/mcp/",
-      "headers": {
-        "Authorization": "Bearer YOUR_TOKEN"
-      }
-    },
-    "@21st-dev/magic": {
-      "type": "stdio",
-      "command": "npx",
-      "args": ["-y", "@21st-dev/magic@latest", "API_KEY=\"your-api-key\""]
-    }
-  }
-}
-```
-
-### Running
-
-**Recommended: Managed through UI**
-
-The recommended way to run the MCP server is through the UI interface:
-
-1. Start the UI server (see main README)
-2. Use the UI's "MCP Server Setup" tab to configure and start the server
-
-**Alternative: Run Directly**
-
-If you need to run the server independently:
-
-```bash
-npm start
-```
-
-The server will start on `http://localhost:9851/mcp`
-
-**Note:** When running directly, ensure you have a valid configuration file at `~/.mcp-shark/mcps.json` before starting. The UI handles configuration automatically when using the recommended workflow.
-
-## 📖 Usage
-
-### Endpoint
-
-All MCP requests should be sent to:
-
-```
-POST http://localhost:9851/mcp
-```
-
-### Example: List All Tools
-
-```bash
-curl -X POST http://localhost:9851/mcp \
-  -H "Content-Type: application/json" \
-  -d '{
-    "jsonrpc": "2.0",
-    "id": 1,
-    "method": "tools/list"
-  }'
-```
-
-### Example: Call a Tool
-
-Tools from different servers are prefixed with the server name:
-
-```bash
-curl -X POST http://localhost:9851/mcp \
-  -H "Content-Type: application/json" \
-  -d '{
-    "jsonrpc": "2.0",
-    "id": 2,
-    "method": "tools/call",
-    "params": {
-      "name": "github:search_repositories",
-      "arguments": {
-        "query": "language:javascript stars:>1000"
-      }
-    }
-  }'
-```
-
-## 🏗️ Architecture
-
-```
-┌─────────────────┐
-│   MCP Client    │
-└────────┬────────┘
-         │ HTTP
-         ▼
-┌─────────────────────────────────┐
-│   MCP Shark Server               │
-│   (Express on port 9851)         │
-│                                   │
-│  ┌────────────────────────────┐ │
-│  │  Internal MCP Server        │ │
-│  │  - tools/list               │ │
-│  │  - tools/call               │ │
-│  │  - prompts/list             │ │
-│  │  - prompts/get              │ │
-│  │  - resources/list           │ │
-│  │  - resources/read           │ │
-│  └──────────┬──────────────────┘ │
-│             │                     │
-│  ┌──────────▼──────────────────┐ │
-│  │  Audit Logger (SQLite)      │ │
-│  └──────────────────────────────┘ │
-└──────────┬────────────────────────┘
-           │
-           ├──► HTTP MCP Server
-           ├──► stdio MCP Server
-           └──► stdio MCP Server
-```
-
-## 📁 Project Structure
-
-```
-mcp-server/
-├── mcp-shark.js            # Main entry point
-├── lib/
-│   ├── server/
-│   │   ├── internal/           # Internal MCP server (aggregator)
-│   │   │   ├── server.js       # Server creation
-│   │   │   ├── run.js          # Express server setup
-│   │   │   ├── session.js      # Session management
-│   │   │   └── handlers/       # Request handlers
-│   │   └── external/           # External MCP server clients
-│   │       ├── all.js          # Multi-server orchestration
-│   │       ├── config.js       # Configuration parsing
-│   │       ├── kv.js           # Key-value store for servers
-│   │       └── single/         # Single server client
-│   ├── db/
-│   │   ├── init.js             # Database initialization
-│   │   ├── logger.js           # Audit logging
-│   │   └── query.js            # Database queries
-│   └── common/
-│       └── error.js            # Error handling utilities
-└── lib/
-    └── ...
-```
-
-**Note:** Configuration and database files are stored in `~/.mcp-shark/` by default:
-
-- `~/.mcp-shark/mcps.json` - Server configuration
-- `~/.mcp-shark/db/mcp-shark.sqlite` - SQLite database
-
-## 🔧 Configuration Format
-
-### HTTP Server
-
-```json
-{
-  "servers": {
-    "server-name": {
-      "type": "http",
-      "url": "https://api.example.com/mcp/",
-      "headers": {
-        "Authorization": "Bearer TOKEN"
-      }
-    }
-  }
-}
-```
-
-### stdio Server
-
-```json
-{
-  "servers": {
-    "server-name": {
-      "type": "stdio",
-      "command": "node",
-      "args": ["path/to/server.js"]
-    }
-  }
-}
-```
-
-## 📊 Audit Logging
-
-All MCP communications are logged to SQLite (default location: `~/.mcp-shark/db/mcp-shark.sqlite`) with:
-
-- **Request/Response Tracking**: Full payload logging with correlation IDs
-- **Performance Metrics**: Duration, latency, and timing information
-- **Error Tracking**: Comprehensive error logging with stack traces
-- **Session Management**: Session ID tracking for stateful interactions
-- **Server Identification**: Track which external server handled each request
-
-### Database Schema
-
-- `mcp_communications`: All request/response communications
-- `mcp_request_response_pairs`: Correlated request/response pairs
-
-## 🛠️ Development
-
-### Scripts
-
-```bash
-# Start the server
-npm start
-
-# Lint code
-npm run lint
-
-# Fix linting issues
-npm run lint:fix
-
-# Format code
-npm run format
-
-# Check formatting
-npm run format:check
-```
-
-### Dependencies
-
-This package uses `mcp-shark-common` for shared database utilities and configuration management. The database initialization and logging functionality is provided by the common package.
-
-### Code Quality
-
-- **ESLint**: Code linting with Prettier integration
-- **Prettier**: Code formatting
-- **Husky**: Git hooks for pre-commit checks
-- **Commitlint**: Conventional commit message validation
-
-## 🔌 Supported MCP Methods
-
-- `tools/list` - List all tools from all servers
-- `tools/call` - Call a tool from any server
-- `prompts/list` - List all prompts from all servers
-- `prompts/get` - Get a specific prompt
-- `resources/list` - List all resources from all servers
-- `resources/read` - Read a specific resource
-
-## 📝 License
-
-ISC
-
-## 🤝 Contributing
-
-Contributions are welcome! Please ensure your code passes linting and formatting checks before submitting.
-
----
-
-**Built with ❤️ using the Model Context Protocol SDK**

package/mcp-server/commitlint.config.cjs

@@ -1,42 +0,0 @@
-module.exports = {
-  extends: ['@commitlint/config-conventional'],
-  rules: {
-    // Type must be one of the following
-    'type-enum': [
-      2,
-      'always',
-      [
-        'feat', // A new feature
-        'fix', // A bug fix
-        'docs', // Documentation only changes
-        'style', // Changes that do not affect the meaning of the code
-        'refactor', // A code change that neither fixes a bug nor adds a feature
-        'perf', // A code change that improves performance
-        'test', // Adding missing tests or correcting existing tests
-        'build', // Changes that affect the build system or external dependencies
-        'ci', // Changes to CI configuration files and scripts
-        'chore', // Other changes that don't modify src or test files
-        'revert', // Reverts a previous commit
-      ],
-    ],
-    // Type case: must be lowercase
-    'type-case': [2, 'always', 'lower-case'],
-    // Type cannot be empty
-    'type-empty': [2, 'never'],
-    // Scope case: must be lowercase
-    'scope-case': [2, 'always', 'lower-case'],
-    // Subject case: sentence-case (first letter lowercase, rest as written)
-    'subject-case': [2, 'never', ['upper-case', 'pascal-case', 'start-case']],
-    // Subject cannot be empty
-    'subject-empty': [2, 'never'],
-    // Subject must end with a period
-    'subject-full-stop': [0, 'never'],
-    // Header must not exceed 72 characters (disabled, using max line length instead)
-    'header-max-length': [2, 'always', 100],
-    // Body must start with blank line
-    'body-leading-blank': [2, 'always'],
-    // Footer must start with blank line
-    'footer-leading-blank': [2, 'always'],
-  },
-};
-

package/mcp-server/eslint.config.js

@@ -1,131 +0,0 @@
-import js from '@eslint/js';
-import prettier from 'eslint-plugin-prettier';
-import prettierConfig from 'eslint-config-prettier';
-
-export default [
-  js.configs.recommended,
-  {
-    files: ['**/*.js'],
-    languageOptions: {
-      ecmaVersion: 'latest',
-      sourceType: 'module',
-      globals: {
-        console: 'readonly',
-        process: 'readonly',
-        Buffer: 'readonly',
-        URL: 'readonly',
-        URLSearchParams: 'readonly',
-        __dirname: 'readonly',
-        __filename: 'readonly',
-        module: 'readonly',
-        require: 'readonly',
-        exports: 'readonly',
-        global: 'readonly',
-      },
-    },
-    plugins: {
-      prettier,
-    },
-    rules: {
-      // Prettier integration
-      'prettier/prettier': 'error',
-
-      // Strict JavaScript rules
-      'no-console': 'off', // Console is expected in CLI tools
-      'no-debugger': 'error',
-      'no-alert': 'error',
-      'no-var': 'error',
-      'prefer-const': 'error',
-      'prefer-arrow-callback': 'error',
-      'prefer-template': 'error',
-      'prefer-spread': 'error',
-      'prefer-rest-params': 'error',
-      'object-shorthand': 'error',
-      'no-duplicate-imports': 'error',
-      'no-useless-constructor': 'error',
-      'no-useless-rename': 'error',
-      'no-param-reassign': 'error',
-      'no-unused-vars': [
-        'error',
-        {
-          argsIgnorePattern: '^_',
-          varsIgnorePattern: '^_',
-          caughtErrorsIgnorePattern: '^_',
-        },
-      ],
-      'no-undef': 'error',
-      'no-use-before-define': 'error',
-      'no-shadow': 'error',
-      'no-implicit-globals': 'error',
-      'no-new-wrappers': 'error',
-      'no-array-constructor': 'error',
-      'no-new-object': 'error',
-      'no-new-func': 'error',
-      'no-iterator': 'error',
-      'no-restricted-syntax': [
-        'error',
-        {
-          selector: 'CallExpression[callee.name="eval"]',
-          message: 'eval() is not allowed.',
-        },
-        {
-          selector: 'CallExpression[callee.name="Function"]',
-          message: 'Function constructor is not allowed.',
-        },
-      ],
-      'no-implied-eval': 'error',
-      'no-script-url': 'error',
-      'no-throw-literal': 'error',
-      'no-return-await': 'error',
-      'require-await': 'error',
-      'no-async-promise-executor': 'error',
-      'no-promise-executor-return': 'error',
-      'no-await-in-loop': 'warn',
-      'no-return-assign': 'error',
-      'no-sequences': 'error',
-      'no-nested-ternary': 'warn',
-      'no-unneeded-ternary': 'error',
-      'no-useless-return': 'error',
-      'no-useless-concat': 'error',
-      'no-useless-escape': 'error',
-      'no-void': 'error',
-      'no-with': 'error',
-      radix: 'error',
-      'vars-on-top': 'error',
-      'wrap-iife': ['error', 'inside'],
-      yoda: 'error',
-      strict: ['error', 'never'], // Use ES modules instead
-      'no-constant-condition': 'error',
-      'no-empty': 'error',
-      'no-empty-character-class': 'error',
-      'no-ex-assign': 'error',
-      'no-extra-boolean-cast': 'error',
-      'no-extra-parens': ['error', 'functions'],
-      'no-extra-semi': 'error',
-      'no-func-assign': 'error',
-      'no-inner-declarations': 'error',
-      'no-invalid-regexp': 'error',
-      'no-irregular-whitespace': 'error',
-      'no-obj-calls': 'error',
-      'no-regex-spaces': 'error',
-      'no-sparse-arrays': 'error',
-      'no-unreachable': 'error',
-      'no-unsafe-finally': 'error',
-      'no-unsafe-negation': 'error',
-      'use-isnan': 'error',
-      'valid-typeof': 'error',
-    },
-  },
-  prettierConfig,
-  {
-    ignores: [
-      'node_modules/**',
-      'dist/**',
-      'build/**',
-      'coverage/**',
-      '*.min.js',
-      '.git/**',
-      '.husky/**',
-    ],
-  },
-];