@react-native-nitro-device-info/mcp-server 1.0.0

package/README.md

@@ -0,0 +1,220 @@
+# @react-native-nitro-device-info/mcp-server
+
+MCP (Model Context Protocol) server for react-native-nitro-device-info that enables AI tools like Claude, Cursor, and Copilot to accurately access library documentation and API information.
+
+## Prerequisites
+
+| Requirement | Version | Notes |
+|-------------|---------|-------|
+| Node.js | ≥20.0.0 | LTS recommended. Check with `node --version` |
+| npm | ≥10.0.0 | Bundled with Node.js 20+ |
+
+## Installation
+
+### Option 1: npx (Recommended)
+
+No installation required. Configure your AI tool to run directly:
+
+```bash
+npx @react-native-nitro-device-info/mcp-server
+```
+
+**Advantages**:
+- Always uses latest version
+- No global installation needed
+- Works immediately after npm registry access
+
+### Option 2: Global Install
+
+```bash
+npm install -g @react-native-nitro-device-info/mcp-server
+```
+
+Then run:
+
+```bash
+nitro-device-info-mcp
+```
+
+## Quick Setup (Recommended)
+
+Run the `init` command in your React Native project to automatically configure MCP for Cursor and Claude Code:
+
+```bash
+cd your-react-native-project
+npx @react-native-nitro-device-info/mcp-server init
+```
+
+This creates:
+- `.cursor/mcp.json` - Cursor IDE configuration
+- `.mcp.json` - Claude Code project configuration
+
+Then restart your IDE and start asking questions!
+
+## Manual Configuration
+
+### Claude Desktop (macOS)
+
+**Configuration file**: `~/Library/Application Support/Claude/claude_desktop_config.json`
+
+**Windows path**: `%APPDATA%\Claude\claude_desktop_config.json`
+
+```json
+{
+  "mcpServers": {
+    "nitro-device-info": {
+      "command": "npx",
+      "args": ["@react-native-nitro-device-info/mcp-server"]
+    }
+  }
+}
+```
+
+**Steps**:
+1. Open the configuration file (create if doesn't exist)
+2. Add the `mcpServers` entry above
+3. Restart Claude Desktop completely (Cmd+Q, then reopen)
+4. Verify: Ask "What battery APIs does react-native-nitro-device-info have?"
+
+### Cursor IDE
+
+**Configuration file**: `.cursor/mcp.json` (in your project root)
+
+```json
+{
+  "mcpServers": {
+    "nitro-device-info": {
+      "command": "npx",
+      "args": ["@react-native-nitro-device-info/mcp-server"]
+    }
+  }
+}
+```
+
+### Generic MCP Client
+
+For any MCP-compatible client using stdio transport:
+
+```json
+{
+  "command": "npx",
+  "args": ["@react-native-nitro-device-info/mcp-server"],
+  "transport": "stdio"
+}
+```
+
+## Verification
+
+### Step 1: Check Server Loading
+
+In Claude Desktop or your AI tool, ask:
+
+> "What tools does the nitro-device-info MCP server provide?"
+
+**Expected response**: Should mention `search_docs`, `get_api`, and `list_apis`.
+
+### Step 2: Test API Lookup
+
+> "Show me the getBatteryLevel API from react-native-nitro-device-info"
+
+### Step 3: Test Search
+
+> "How do I check if headphones are connected?"
+
+### Step 4: Test List
+
+> "List all battery-related APIs"
+
+## Available Tools
+
+| Tool | Purpose | Example Query |
+|------|---------|---------------|
+| `search_docs` | Search documentation with natural language | "how to get device model" |
+| `get_api` | Get detailed info about a specific API | "show me getBatteryLevel" |
+| `list_apis` | List APIs by category, platform, or type | "list all network APIs" |
+
+## Usage Examples
+
+### Basic Questions
+
+> "How do I get the device's battery level?"
+
+The AI will query the MCP server and provide accurate API information:
+
+```typescript
+import { NitroModules } from 'react-native-nitro-modules';
+import type { DeviceInfo } from 'react-native-nitro-device-info';
+
+const deviceInfo = NitroModules.createHybridObject<DeviceInfo>('DeviceInfo');
+
+// Get battery level (0.0 to 1.0)
+const batteryLevel = deviceInfo.getBatteryLevel();
+console.log(`Battery: ${Math.round(batteryLevel * 100)}%`);
+```
+
+### API Discovery
+
+> "What APIs are available for network information?"
+
+### Troubleshooting Questions
+
+> "Why does getIpAddress return empty on iOS simulator?"
+
+## Troubleshooting
+
+### Server Not Loading
+
+**Symptom**: AI doesn't recognize react-native-nitro-device-info questions
+
+**Diagnostic steps**:
+
+1. **Check Node.js version**:
+   ```bash
+   node --version  # Must be v20.0.0 or higher
+   ```
+
+2. **Verify npx works**:
+   ```bash
+   npx --version
+   ```
+
+3. **Test server directly**:
+   ```bash
+   npx @react-native-nitro-device-info/mcp-server --help
+   ```
+
+4. **Check Claude Desktop logs** (macOS):
+   ```bash
+   tail -f ~/Library/Logs/Claude/mcp*.log
+   ```
+
+### Common Issues
+
+| Issue | Cause | Solution |
+|-------|-------|----------|
+| "command not found" | Node.js not in PATH | Reinstall Node.js or add to PATH |
+| "npm ERR! 404" | Package not published | Wait for npm publish or build from source |
+| JSON parse error | Invalid config syntax | Check for trailing commas, quotes |
+| Server timeout | Slow network/registry | Use global install for offline use |
+
+## Development
+
+### Run from Source
+
+```bash
+git clone https://github.com/l2hyunwoo/react-native-nitro-device-info.git
+cd react-native-nitro-device-info
+yarn install
+yarn workspace @react-native-nitro-device-info/mcp-server build
+yarn workspace @react-native-nitro-device-info/mcp-server start
+```
+
+### Run Tests
+
+```bash
+yarn workspace @react-native-nitro-device-info/mcp-server test
+```
+
+## License
+
+MIT

package/dist/cli/init.d.ts

@@ -0,0 +1,12 @@
+/**
+ * CLI init command - generates MCP configuration files
+ *
+ * Supports:
+ * - .cursor/mcp.json for Cursor IDE
+ * - .mcp.json for Claude Code (project-level)
+ */
+/**
+ * Run the init command
+ */
+export declare function runInit(): Promise<void>;
+//# sourceMappingURL=init.d.ts.map

package/dist/cli/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/cli/init.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAyGH;;GAEG;AACH,wBAAsB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAkC7C"}

package/dist/cli/init.js

@@ -0,0 +1,153 @@
+"use strict";
+/**
+ * CLI init command - generates MCP configuration files
+ *
+ * Supports:
+ * - .cursor/mcp.json for Cursor IDE
+ * - .mcp.json for Claude Code (project-level)
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runInit = runInit;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const MCP_SERVER_CONFIG = {
+    command: 'npx',
+    args: ['@react-native-nitro-device-info/mcp-server'],
+};
+const SERVER_NAME = 'nitro-device-info';
+/**
+ * Merge MCP server config into existing config
+ */
+function mergeConfig(existing) {
+    if (!existing) {
+        return {
+            mcpServers: {
+                [SERVER_NAME]: MCP_SERVER_CONFIG,
+            },
+        };
+    }
+    return {
+        ...existing,
+        mcpServers: {
+            ...existing.mcpServers,
+            [SERVER_NAME]: MCP_SERVER_CONFIG,
+        },
+    };
+}
+/**
+ * Read existing JSON config file
+ */
+function readJsonFile(filePath) {
+    try {
+        if (fs.existsSync(filePath)) {
+            const content = fs.readFileSync(filePath, 'utf-8');
+            return JSON.parse(content);
+        }
+    }
+    catch {
+        // File doesn't exist or invalid JSON
+    }
+    return null;
+}
+/**
+ * Write JSON config file
+ */
+function writeJsonFile(filePath, config) {
+    const dir = path.dirname(filePath);
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+    fs.writeFileSync(filePath, JSON.stringify(config, null, 2) + '\n');
+}
+/**
+ * Initialize Cursor MCP configuration
+ */
+function initCursor(projectRoot) {
+    const configPath = path.join(projectRoot, '.cursor', 'mcp.json');
+    const existing = readJsonFile(configPath);
+    const merged = mergeConfig(existing);
+    // Check if already configured
+    if (existing?.mcpServers?.[SERVER_NAME]) {
+        return { created: false, path: configPath };
+    }
+    writeJsonFile(configPath, merged);
+    return { created: true, path: configPath };
+}
+/**
+ * Initialize Claude Code MCP configuration (.mcp.json)
+ */
+function initClaudeCode(projectRoot) {
+    const configPath = path.join(projectRoot, '.mcp.json');
+    const existing = readJsonFile(configPath);
+    const merged = mergeConfig(existing);
+    // Check if already configured
+    if (existing?.mcpServers?.[SERVER_NAME]) {
+        return { created: false, path: configPath };
+    }
+    writeJsonFile(configPath, merged);
+    return { created: true, path: configPath };
+}
+/**
+ * Run the init command
+ */
+async function runInit() {
+    const projectRoot = process.cwd();
+    console.log('Initializing MCP configuration for react-native-nitro-device-info...\n');
+    // Initialize Cursor
+    const cursorResult = initCursor(projectRoot);
+    if (cursorResult.created) {
+        console.log(`✓ Created ${path.relative(projectRoot, cursorResult.path)}`);
+    }
+    else {
+        console.log(`• ${path.relative(projectRoot, cursorResult.path)} (already configured)`);
+    }
+    // Initialize Claude Code
+    const claudeResult = initClaudeCode(projectRoot);
+    if (claudeResult.created) {
+        console.log(`✓ Created ${path.relative(projectRoot, claudeResult.path)}`);
+    }
+    else {
+        console.log(`• ${path.relative(projectRoot, claudeResult.path)} (already configured)`);
+    }
+    console.log('\nMCP configuration complete!\n');
+    console.log('Next steps:');
+    console.log('  • Cursor IDE: Restart Cursor to load the MCP server');
+    console.log('  • Claude Code: The MCP server will be available in your project');
+    console.log('\nYou can now ask AI assistants about react-native-nitro-device-info:');
+    console.log('  "How do I get the device\'s battery level?"');
+    console.log('  "What network APIs are available?"');
+}
+//# sourceMappingURL=init.js.map

package/dist/cli/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/cli/init.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+#!/usr/bin/env node
+/**
+ * MCP Server for react-native-nitro-device-info
+ *
+ * Enables AI tools like Claude, Cursor, and Copilot to access
+ * accurate API documentation for the react-native-nitro-device-info library.
+ *
+ * Usage:
+ *   npx @react-native-nitro-device-info/mcp-server         # Start MCP server
+ *   npx @react-native-nitro-device-info/mcp-server init    # Initialize config files
+ *   npx @react-native-nitro-device-info/mcp-server --help  # Show help
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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