@deriv-com/fe-mcp-servers 0.0.3 → 0.0.5

package/README.md

@@ -5,35 +5,59 @@ A collection of Front-End Model Context Protocol (MCP) servers for reusability a
 ## 🏗️ Project Structure
 
 ```
-fe-mcp-servers/
-├── servers/                    # All MCP servers
-│   ├── server-name-1/         # Individual MCP server
-│   │   ├── src/
-│   │   │   ├── mcp-server.js  # Main server implementation
-│   │   │   ├── server-logic.js # Core functionality
-│   │   │   └── test-mcp.js    # Test suite
-│   │   └── README.md          # Server documentation
-│   └── server-name-2/         # Another MCP server
-│       └── ...
-├── scripts/                   # Build and test scripts
-│   ├── build.js              # Package builder
-│   └── test-all.js           # Test runner
-├── dist/                     # Built package (auto-generated)
-├── package.json              # Main package configuration
-└── README.md                 # This file
+mcps/
+├── shift-ai/                  # Individual MCP server
+│   ├── src/
+│   │   ├── mcp-server.js     # Main server implementation
+│   │   ├── mcp.js            # Core functionality
+│   │   └── test-mcp.js       # Test suite
+│   └── README.md             # Server documentation
+├── github-mcp/               # GitHub integration server (planned)
+├── slack-mcp/                # Slack automation server (planned)
+├── database-mcp/             # Database management server (planned)
+├── scripts/                  # Build and test scripts
+│   ├── build.js             # Package builder
+│   └── test-all.js          # Test runner
+├── package.json             # MCP package configuration
+└── README.md                # This file
 ```
 
-## 🚀 Usage
+## 🚀 Installation & Usage
 
-MCP servers are distributed via npm and accessible through jsDelivr CDN for zero-installation setup.
+### Install the Package
+```bash
+# Install globally
+npm install -g @deriv/ai-tools
+```
+
+### Get Your Configuration Path
+Copy and run this command to get the exact path for your MCP configuration:
+
+```bash
+echo "$(npm root -g)/@deriv/ai-tools/mcps/dist/SERVER_NAME/src/mcp-server.js"
+```
+
+Replace `SERVER_NAME` with the specific server you want (e.g., `shift-ai`).
 
-**General Usage Pattern:**
+### MCP Configuration Template
 ```json
 {
   "mcpServers": {
     "server-name": {
       "command": "node",
-      "args": ["https://cdn.jsdelivr.net/npm/@deriv-com/fe-mcp-servers@latest/dist/server-name/src/mcp-server.js"]
+      "args": ["<PASTE_PATH_FROM_ABOVE>"]
+    }
+  }
+}
+```
+
+### Example Configuration
+```json
+{
+  "mcpServers": {
+    "shift-ai": {
+      "command": "node",
+      "args": ["/Users/user/.nvm/versions/node/v20.17.0/lib/node_modules/@deriv/ai-tools/mcps/dist/shift-ai/src/mcp-server.js"]
     }
   }
 }
@@ -43,6 +67,7 @@ MCP servers are distributed via npm and accessible through jsDelivr CDN for zero
 
 ### Building the Package
 ```bash
+cd mcps
 npm run build
 ```
 
@@ -53,22 +78,48 @@ npm run test
 
 ### Adding New MCP Servers
 
-1. Create a new directory in `servers/`
+1. Create a new directory in `mcps/`
 2. Add the required structure:
    ```
-   servers/your-server/
+   your-server/
    ├── src/
    │   ├── mcp-server.js    # Required: Main MCP server
    │   ├── your-logic.js    # Your server logic
    │   └── test-mcp.js      # Optional: Tests
    └── README.md            # Required: Documentation
    ```
-3. Use standard npm imports (dependencies are resolved from root)
+3. Use standard npm imports (dependencies are resolved from mcps root)
 4. The build script will automatically include it
 
+## Available MCP Servers
+
+### 🚀 shift-ai
+AI code generation and analysis server that provides intelligent code suggestions, analysis, and automated code generation capabilities.
+
+**Status**: ✅ Active
+**Location**: `shift-ai/`
+
+### 🐙 github-mcp
+GitHub integration server for repository management, issue tracking, and pull request automation.
+
+**Status**: 🚧 Planned
+**Location**: `github-mcp/`
+
+### 💬 slack-mcp
+Slack workspace automation server for communication workflows and bot integrations.
+
+**Status**: 🚧 Planned
+**Location**: `slack-mcp/`
+
+### 🗄️ database-mcp
+Database query and schema management server supporting multiple database systems.
+
+**Status**: 🚧 Planned
+**Location**: `database-mcp/`
+
 ## 📦 Distribution
 
-This package is published to npm and distributed via jsDelivr CDN for zero-installation access to MCP servers.
+This package is published to npm as part of the @deriv/ai-tools collection with all dependencies bundled for easy installation and usage.
 
 ## 🔧 Standards
 
@@ -82,10 +133,10 @@ Each MCP server must:
 ## 🏗️ Architecture
 
 - **Monorepo Structure**: All servers in one package for easy distribution
-- **Shared Dependencies**: Common dependencies bundled at root level
+- **Shared Dependencies**: Common dependencies bundled at mcps level
 - **Automatic Discovery**: Build system automatically finds and includes servers
-- **CDN Distribution**: Zero-installation access via jsDelivr
+- **Global Installation**: Zero-configuration setup via npm global install
 - **Standardized Structure**: Consistent patterns across all servers
-
-
-
+- **Protocol**: [Model Context Protocol (MCP)](https://modelcontextprotocol.io/)
+- **Runtime**: Node.js
+- **Build System**: Automated packaging and distribution 

package/dist/shift-ai/README.md

@@ -2,7 +2,7 @@
 
 An MCP (Model Context Protocol) server that provides AI code provenance tracking through simple comment markers. This tool helps maintain transparency and traceability of AI-generated code across different programming languages.
 
-## 🎯 Features
+## ✨ Features
 
 - **Universal Code Wrapping**: Supports JavaScript, TypeScript, Python, CSS, HTML, and more
 - **Simple Comment Markers**: Uses language-appropriate comment syntax for wrapping
@@ -11,52 +11,61 @@ An MCP (Model Context Protocol) server that provides AI code provenance tracking
 - **Zero Configuration**: Works out of the box with sensible defaults
 - **Language Detection**: Automatically applies correct comment syntax for each file type
 
-## 🚀 Usage
+## 🚀 Installation
 
+### Install the Package
+```bash
+npm install -g @deriv-com/fe-mcp-servers
+```
+
+### Get ShiftAI Configuration Path
+Copy and run this command to get the exact path for ShiftAI:
+
+```bash
+echo "$(npm root -g)/@deriv-com/fe-mcp-servers/dist/shift-ai/src/mcp-server.js"
+```
+
+This will output the full path that you can copy directly into your MCP configuration.
+
+## 📋 Configuration
+
+### Cursor IDE
 ```json
 {
   "mcpServers": {
-    "shiftai": {
+    "shift-ai": {
       "command": "node",
-      "args": ["https://cdn.jsdelivr.net/npm/@deriv-com/fe-mcp-servers@latest/dist/shift-ai/src/mcp-server.js"]
+      "args": ["<PASTE_PATH_FROM_ABOVE>"]
     }
   }
 }
 ```
 
-## ⚙️ Configuration Examples
-
-### Cursor IDE
-
-Add to your `cursor-settings.json`:
-
+### Claude Desktop
 ```json
 {
   "mcpServers": {
-    "shiftai": {
+    "shift-ai": {
       "command": "node",
-      "args": ["https://cdn.jsdelivr.net/npm/@deriv-com/fe-mcp-servers@latest/dist/shift-ai/src/mcp-server.js"]
+      "args": ["<PASTE_PATH_FROM_ABOVE>"]
     }
   }
 }
 ```
 
-### Claude Desktop
-
-Add to your `claude_desktop_config.json`:
-
+### Example Configuration
 ```json
 {
   "mcpServers": {
-    "shiftai": {
+    "shift-ai": {
       "command": "node",
-      "args": ["https://cdn.jsdelivr.net/npm/@deriv-com/fe-mcp-servers@latest/dist/shift-ai/src/mcp-server.js"]
+      "args": ["/Users/user/.nvm/versions/node/v20.17.0/lib/node_modules/@deriv-com/fe-mcp-servers/dist/shift-ai/src/mcp-server.js"]
     }
   }
 }
 ```
 
-## 🚀 Usage
+## 🛠️ Usage
 
 Once configured, you can use the `shai` tool in your AI conversations:
 
@@ -105,19 +114,34 @@ Generates code wrapped according to AI code provenance rules.
 
 - Formatted instructions with examples for proper AI code wrapping
 
-## 📋 Comment Formats by Language
+## 🏗️ Project Structure
+
+```
+shift-ai/
+├── src/
+│   ├── mcp-server.js    # Main MCP server implementation
+│   ├── mcp.js          # Core shai function
+│   └── test-mcp.js     # Test suite
+└── README.md          # This file
+```
+
+## 🔧 Dependencies
 
-| Language/File Type    | Wrapper Format                                     |
-| --------------------- | -------------------------------------------------- |
-| JavaScript/TypeScript | `// [AI]`<br/>code here<br/>`// [/AI]`             |
-| Python/Shell/Ruby     | `# [AI]`<br/>code here<br/>`# [/AI]`               |
-| CSS/SCSS/Sass/Less    | `/* [AI]`<br/>code here<br/>`[/AI] */`             |
-| HTML/XML/Markdown     | `<!-- [AI] -->`<br/>code here<br/>`<!-- [/AI] -->` |
+- `@modelcontextprotocol/sdk`: MCP protocol implementation
+- Additional dependencies bundled automatically
 
-## 💡 Examples
+## 📝 Comment Formats
 
-### JavaScript Example
+| Language/File Type     | Wrapper Format                    |
+|----------------------- |-----------------------------------|
+| JavaScript/TypeScript | `// [AI]`...`// [/AI]`           |
+| Python/Shell/Ruby     | `# [AI]`...`# [/AI]`             |
+| CSS/SCSS/Sass/Less    | `/* [AI]`...`[/AI] */`           |
+| HTML/XML/Markdown     | `<!-- [AI] -->`...`<!-- [/AI] -->` |
 
+## 📊 Examples
+
+### JavaScript/TypeScript
 ```javascript
 // [AI]
 function fibonacci(n) {
@@ -130,8 +154,7 @@ function fibonacci(n) {
 // [/AI]
 ```
 
-### Python Example
-
+### Python
 ```python
 # [AI]
 def fibonacci(n):
@@ -141,46 +164,4 @@ def fibonacci(n):
     return sequence[:n]
 # [/AI]
 ```
-### CSS Example
-
-```css
-/* [AI] */
-.fibonacci-result {
-  padding: 20px;
-  background: #f5f5f5;
-  border-radius: 8px;
-  margin: 10px 0;
-}
-/* [/AI] */
-```
-
-### HTML Example
-
-```html
-<!-- [AI] -->
-<div class="fibonacci-result">
-  <h2>Fibonacci Sequence</h2>
-  <p>Result: [0, 1, 1, 2, 3, 5, 8, 13, 21, 34]</p>
-</div>
-<!-- [/AI] -->
-```
-
-## 🎯 Key Rules
-
-1. **Always use the correct comment syntax** for the file type
-2. **The code inside the wrapper must be actual code**, not commented out
-3. **Use simple opening and closing markers** - no complex metadata required
-4. **Consistent formatting** - opening marker on its own line, closing marker on its own line
-
-### Project Structure
-
-```
-shift-ai/
-├── src/
-│   ├── mcp.js          # Core shai function logic
-│   ├── mcp-server.js   # MCP server implementation
-│   └── test-mcp.js     # Test suite
-├── package.json        # Project configuration
-└── README.md           # This documentation
-```
 

package/dist/shift-ai/src/mcp-server.js

@@ -32,7 +32,7 @@ All code suggestions from any AI tool or agent must be wrapped in simple comment
 |------------------------|-----------------------------------|
 | JavaScript/TypeScript  | // [AI]\\ncode here\\n// [/AI]    |
 | Python/Shell/Ruby      | # [AI]\\ncode here\\n# [/AI]      |
-| CSS/SCSS/Sass/Less     | /* [AI]\\ncode here\\n[/AI] */    |
+| CSS/SCSS/Sass/Less     | /* [AI] */\\ncode here\\n/* [/AI] */ |
 | HTML/XML/Markdown      | <!-- [AI] -->\\ncode here\\n<!-- [/AI] --> |
 
 ## Examples
@@ -63,11 +63,11 @@ def fibonacci(n):
 <!-- [/AI] -->
 
 **CSS:**
-/* [AI]
+/* [AI] */
 .class {
   property: value;
 }
-[/AI] */
+/* [/AI] */
 
 ## Key Rules
 

package/dist/shift-ai/src/mcp.js

@@ -22,7 +22,7 @@ All code suggestions from any AI tool or agent must be wrapped in simple comment
 |------------------------|-----------------------------------|
 | JavaScript/TypeScript  | // [AI]\\ncode here\\n// [/AI]    |
 | Python/Shell/Ruby      | # [AI]\\ncode here\\n# [/AI]      |
-| CSS/SCSS/Sass/Less     | /* [AI]\\ncode here\\n[/AI] */    |
+| CSS/SCSS/Sass/Less     | /* [AI] */\\ncode here\\n/* [/AI] */ |
 | HTML/XML/Markdown      | <!-- [AI] -->\\ncode here\\n<!-- [/AI] --> |
 
 ## Examples
@@ -67,7 +67,7 @@ print(fibonacci(10))
 
 **CSS:**
 \`\`\`css
-/* [AI]
+/* [AI] */
 .fibonacci-result {
   padding: 20px;
   background: #f5f5f5;
@@ -79,7 +79,7 @@ print(fibonacci(10))
   color: #333;
   margin-bottom: 10px;
 }
-[/AI] */
+/* [/AI] */
 \`\`\`
 
 ## Key Rules

package/package.json

@@ -1,16 +1,16 @@
 {
   "name": "@deriv-com/fe-mcp-servers",
-  "version": "0.0.3",
+  "version": "0.0.5",
   "description": "Collection of Front-End Model Context Protocol (MCP) servers for reusability and standardization",
   "type": "module",
   "scripts": {
-    "build": "node scripts/build.js",
-    "test": "node scripts/test-all.js",
+    "build": "node ../scripts/mcp/build.js",
+    "test": "node ../scripts/mcp/test-all.js",
     "prepublishOnly": "npm run build && npm run test"
   },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/deriv-com/fe-mcp-servers.git"
+    "url": "git+https://github.com/deriv-com/fe-ai-tools.git"
   },
   "publishConfig": {
     "access": "public"

package/node_modules/@modelcontextprotocol/sdk/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2024 Anthropic, PBC
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.

package/node_modules/@modelcontextprotocol/sdk/README.md

@@ -1,105 +0,0 @@
-# MCP TypeScript SDK ![NPM Version](https://img.shields.io/npm/v/%40modelcontextprotocol%2Fsdk)
-
-TypeScript implementation of the [Model Context Protocol](https://modelcontextprotocol.io) (MCP), providing both client and server capabilities for integrating with LLM surfaces.
-
-## Overview
-
-The Model Context Protocol allows applications to provide context for LLMs in a standardized way, separating the concerns of providing context from the actual LLM interaction. This TypeScript SDK implements the full MCP specification, making it easy to:
-
-- Build MCP clients that can connect to any MCP server
-- Create MCP servers that expose resources, prompts and tools
-- Use standard transports like stdio and SSE
-- Handle all MCP protocol messages and lifecycle events
-
-## Installation
-
-```bash
-npm install @modelcontextprotocol/sdk
-```
-
-## Quick Start
-
-### Creating a Client
-
-```typescript
-import { Client } from "@modelcontextprotocol/sdk/client";
-import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio";
-
-const transport = new StdioClientTransport({
-  command: "path/to/server",
-});
-
-const client = new Client({
-  name: "example-client",
-  version: "1.0.0",
-});
-
-await client.connect(transport);
-
-// List available resources
-const resources = await client.request(
-  { method: "resources/list" },
-  ListResourcesResultSchema
-);
-
-// Read a specific resource
-const resourceContent = await client.request(
-  {
-    method: "resources/read",
-    params: {
-      uri: "file:///example.txt"
-    }
-  },
-  ReadResourceResultSchema
-);
-```
-
-### Creating a Server
-
-```typescript
-import { Server } from "@modelcontextprotocol/sdk/server";
-import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio";
-
-const server = new Server({
-  name: "example-server",
-  version: "1.0.0",
-});
-
-server.setRequestHandler(ListResourcesRequestSchema, async () => {
-  return {
-    resources: [
-      {
-        uri: "file:///example.txt",
-        name: "Example Resource",
-      },
-    ],
-  };
-});
-
-server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
-  if (request.params.uri === "file:///example.txt") {
-    return {
-      contents: [
-        {
-          uri: "file:///example.txt",
-          mimeType: "text/plain",
-          text: "This is the content of the example resource.",
-        },
-      ],
-    };
-  } else {
-    throw new Error("Resource not found");
-  }
-});
-
-const transport = new StdioServerTransport();
-await server.connect(transport);
-```
-
-## Contributing
-
-Issues and pull requests are welcome on GitHub at https://github.com/modelcontextprotocol/typescript-sdk.
-
-## License
-
-This project is licensed under the MIT License—see the [LICENSE](LICENSE) file for details.

package/node_modules/@modelcontextprotocol/sdk/dist/cli.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=cli.d.ts.map

package/node_modules/@modelcontextprotocol/sdk/dist/cli.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/node_modules/@modelcontextprotocol/sdk/dist/cli.js

@@ -1,129 +0,0 @@
-import EventSource from "eventsource";
-import WebSocket from "ws";
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-global.EventSource = EventSource;
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-global.WebSocket = WebSocket;
-import express from "express";
-import { Client } from "./client/index.js";
-import { SSEClientTransport } from "./client/sse.js";
-import { StdioClientTransport } from "./client/stdio.js";
-import { WebSocketClientTransport } from "./client/websocket.js";
-import { Server } from "./server/index.js";
-import { SSEServerTransport } from "./server/sse.js";
-import { StdioServerTransport } from "./server/stdio.js";
-import { ListResourcesResultSchema } from "./types.js";
-async function runClient(url_or_command, args) {
-    const client = new Client({
-        name: "mcp-typescript test client",
-        version: "0.1.0",
-    }, {
-        capabilities: {
-            sampling: {},
-        },
-    });
-    let clientTransport;
-    let url = undefined;
-    try {
-        url = new URL(url_or_command);
-    }
-    catch (_a) {
-        // Ignore
-    }
-    if ((url === null || url === void 0 ? void 0 : url.protocol) === "http:" || (url === null || url === void 0 ? void 0 : url.protocol) === "https:") {
-        clientTransport = new SSEClientTransport(new URL(url_or_command));
-    }
-    else if ((url === null || url === void 0 ? void 0 : url.protocol) === "ws:" || (url === null || url === void 0 ? void 0 : url.protocol) === "wss:") {
-        clientTransport = new WebSocketClientTransport(new URL(url_or_command));
-    }
-    else {
-        clientTransport = new StdioClientTransport({
-            command: url_or_command,
-            args,
-        });
-    }
-    console.log("Connected to server.");
-    await client.connect(clientTransport);
-    console.log("Initialized.");
-    await client.request({ method: "resources/list" }, ListResourcesResultSchema);
-    await client.close();
-    console.log("Closed.");
-}
-async function runServer(port) {
-    if (port !== null) {
-        const app = express();
-        let servers = [];
-        app.get("/sse", async (req, res) => {
-            console.log("Got new SSE connection");
-            const transport = new SSEServerTransport("/message", res);
-            const server = new Server({
-                name: "mcp-typescript test server",
-                version: "0.1.0",
-            }, {
-                capabilities: {},
-            });
-            servers.push(server);
-            server.onclose = () => {
-                console.log("SSE connection closed");
-                servers = servers.filter((s) => s !== server);
-            };
-            await server.connect(transport);
-        });
-        app.post("/message", async (req, res) => {
-            console.log("Received message");
-            const sessionId = req.query.sessionId;
-            const transport = servers
-                .map((s) => s.transport)
-                .find((t) => t.sessionId === sessionId);
-            if (!transport) {
-                res.status(404).send("Session not found");
-                return;
-            }
-            await transport.handlePostMessage(req, res);
-        });
-        app.listen(port, () => {
-            console.log(`Server running on http://localhost:${port}/sse`);
-        });
-    }
-    else {
-        const server = new Server({
-            name: "mcp-typescript test server",
-            version: "0.1.0",
-        }, {
-            capabilities: {
-                prompts: {},
-                resources: {},
-                tools: {},
-                logging: {},
-            },
-        });
-        const transport = new StdioServerTransport();
-        await server.connect(transport);
-        console.log("Server running on stdio");
-    }
-}
-const args = process.argv.slice(2);
-const command = args[0];
-switch (command) {
-    case "client":
-        if (args.length < 2) {
-            console.error("Usage: client <server_url_or_command> [args...]");
-            process.exit(1);
-        }
-        runClient(args[1], args.slice(2)).catch((error) => {
-            console.error(error);
-            process.exit(1);
-        });
-        break;
-    case "server": {
-        const port = args[1] ? parseInt(args[1]) : null;
-        runServer(port).catch((error) => {
-            console.error(error);
-            process.exit(1);
-        });
-        break;
-    }
-    default:
-        console.error("Unrecognized command:", command);
-}
-//# sourceMappingURL=cli.js.map