@deriv-com/fe-mcp-servers 0.0.1 → 0.0.4

package/README.md

@@ -1,96 +1,116 @@
-# Front-End MCP Servers Repository
+# FE MCP Servers
 
-A centralized repository for Front-End Model Context Protocol (MCP) servers, designed for reusability, standardization, and easy integration across projects.
+A collection of Front-End Model Context Protocol (MCP) servers for reusability and standardization.
 
-## 📋 Overview
-
-This repository serves as a collection of MCP servers specifically tailored for front-end development workflows. Each MCP server is organized in its own directory with comprehensive documentation and standardized structure to ensure consistency and ease of use.
-
-## 🏗️ Repository Structure
+## 🏗️ Project Structure
 
 ```
 fe-mcp-servers/
-├── README.md                    # This file - main repository documentation
-├── server-name-1/              # Individual MCP server directory
-│   ├── README.md               # Server-specific documentation
-│   ├── src/                    # Source code
-│   ├── package.json            # Dependencies and scripts
-│   └── ...                     # Other server files
-├── server-name-2/              # Another MCP server
-│   ├── README.md
-│   └── ...
-└── docs/                       # Additional documentation (optional)
+├── 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
 ```
 
-## 📚 MCP Server Standards
-
-Each MCP server in this repository must follow these standards:
-
-### Directory Structure
-- **One directory per MCP server**
-- **Descriptive, kebab-case naming** (e.g., `ui-component-generator`, `css-utility-server`)
-- **Self-contained** - all dependencies and configuration within the directory
-
-### Required Files
-Each MCP server directory **must** include:
-
-1. **README.md** - Comprehensive documentation (see template below)
-2. **package.json** - Node.js dependencies and metadata
-3. **src/** directory - Source code and implementation
-4. **Configuration files** - Any necessary config files (tsconfig.json, etc.)
-
-### README.md Template
-
-Each server's README.md should include:
-
-```markdown
-# [Server Name]
+## 🚀 Installation & Usage
 
-Brief description of what this MCP server does.
-
-## Features
-- Feature 1
-- Feature 2
-- Feature 3
-
-## Installation
-Instructions for installing and setting up the server.
+### Install the Package
+```bash
+# Install globally
+npm install -g @deriv-com/fe-mcp-servers
+```
 
-## Configuration
-Configuration options and examples.
+### Get Your Configuration Path
+Copy and run this command to get the exact path for your MCP configuration:
 
-## Usage
-How to use the server, including:
-- Available tools/functions
-- Example requests and responses
-- Integration examples
+```bash
+echo "$(npm root -g)/@deriv-com/fe-mcp-servers/dist/SERVER_NAME/src/mcp-server.js"
+```
 
-## API Reference
-Detailed documentation of available functions.
+Replace `SERVER_NAME` with the specific server you want (e.g., `shift-ai`).
+
+### MCP Configuration Template
+```json
+{
+  "mcpServers": {
+    "server-name": {
+      "command": "node",
+      "args": ["<PASTE_PATH_FROM_ABOVE>"]
+    }
+  }
+}
+```
 
-## Examples
-Practical usage examples and code snippets.
+### Example Configuration
+```json
+{
+  "mcpServers": {
+    "shift-ai": {
+      "command": "node",
+      "args": ["/Users/user/.nvm/versions/node/v20.17.0/lib/node_modules/@deriv-com/fe-mcp-servers/dist/shift-ai/src/mcp-server.js"]
+    }
+  }
+}
+```
 
-## Contributing
-Guidelines for contributing to this specific server.
+## 🛠️ Development
 
-## License
-License information.
+### Building the Package
+```bash
+npm run build
 ```
 
-## 🚀 Getting Started
-
-### For Users
-1. Browse the available MCP servers in this repository
-2. Navigate to the server directory you're interested in
-3. Follow the installation and usage instructions in that server's README.md
+### Running Tests
+```bash
+npm run test
+```
 
-### For Contributors
-1. Fork this repository
-2. Create a new directory for your MCP server
-3. Follow the standardization guidelines above
-4. Ensure your server includes comprehensive documentation
-5. Submit a pull request
+### Adding New MCP Servers
+
+1. Create a new directory in `servers/`
+2. Add the required structure:
+   ```
+   servers/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)
+4. The build script will automatically include it
+
+## 📦 Distribution
+
+This package is published to npm with all dependencies bundled for easy installation and usage.
+
+## 🔧 Standards
+
+Each MCP server must:
+- Have `src/mcp-server.js` as the main entry point
+- Use standard npm package imports
+- Include comprehensive `README.md` documentation
+- Follow consistent coding patterns
+- Include test coverage where applicable
+
+## 🏗️ Architecture
+
+- **Monorepo Structure**: All servers in one package for easy distribution
+- **Shared Dependencies**: Common dependencies bundled at root level
+- **Automatic Discovery**: Build system automatically finds and includes servers
+- **Global Installation**: Zero-configuration setup via npm global install
+- **Standardized Structure**: Consistent patterns across all servers
 
 
 

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):
@@ -142,45 +165,3 @@ def fibonacci(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/node_modules/@modelcontextprotocol/sdk/LICENSE

@@ -0,0 +1,21 @@
+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

@@ -0,0 +1,105 @@
+# 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

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

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

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