Skip to main content
Glama
lallen30

BluestoneApps MCP Remote Server

by lallen30
README.md
# MCP Remote Server (Node.js Version)

This is a Node.js implementation of the BluestoneApps Coding Standards and Examples MCP server.

## Overview

This MCP server provides access to React Native coding standards and code examples through the Model Context Protocol (MCP). It can be used with MCP clients like Windsurf IDE.

## Features

- Access to React Native coding standards
- Component, hook, screen, service, and theme code examples
- Fuzzy matching for finding examples by name
- Full integration with the MCP protocol

## Installation

1. Clone this repository
2. Install dependencies:
   ```bash
   npm install
   ```
3. Build the project:
   ```bash
   npm run build
   ```

## Usage

Start the server:

```bash
npm start
```

To use with MCP clients, configure them to connect to this server.

## Tools

The server provides the following tools:

- `get_project_structure`: Get project structure standards
- `get_api_communication`: Get API communication standards 
- `get_component_design`: Get component design standards
- `get_state_management`: Get state management standards
- `get_component_example`: Get a specific component example
- `get_hook_example`: Get a specific hook example
- `get_service_example`: Get a specific service example 
- `get_screen_example`: Get a specific screen example
- `get_theme_example`: Get a specific theme example
- `list_available_examples`: List all available code examples

## Configuring with MCP Clients

For Windsurf IDE, update the `mcp_config.json` with:

```json
{
  "servers": {
    "bluestoneapps": {
      "command": "node",
      "args": ["/path/to/build/index.js"],
      "description": "BluestoneApps Coding Standards and Examples",
      "displayName": "BluestoneApps MCP Server",
      "timeout": 30000
    }
  }
}

TDQS

B3.4/5.0

Scored across 10 tools

Disambiguation4/5

Most tools have clearly distinct purposes targeting different aspects of React Native development (standards, examples, structure). However, there is some potential overlap between 'get_component_example' and 'get_screen_example' since screens are composed of components, which could cause minor confusion about which to use for component-level examples.

Naming Consistency5/5

All tools follow a consistent 'verb_noun' pattern using 'get_' or 'list_' prefixes with snake_case naming. The naming convention is perfectly uniform across all 10 tools, making them predictable and easy to understand.

Tool Count5/5

With 10 tools, this server is well-scoped for its purpose of providing React Native development standards and examples. Each tool serves a specific, valuable function, and the count is neither too sparse nor overwhelming for this educational/reference domain.

Completeness4/5

The tool set provides comprehensive coverage for retrieving standards and examples across key React Native development areas (components, hooks, screens, services, state management, theming, project structure, API communication). A minor gap is the lack of tools for creating or modifying these resources, but as a reference server focused on 'getting' information, it's reasonably complete.

Maintenance

ActivityInactive
ResponsivenessNo issues