@arjun_01/linq-mcp-server

Official MCP (Model Context Protocol) server for Linq workspace management and AI assistant integration.

Overview

This package provides a fully-featured MCP server that enables AI assistants to access and interact with your Linq workspaces. It supports:

• ✅ Workspace Management - List and access workspaces with proper permissions
• ✅ Advanced Data Search - Semantic search with complex filtering and ranking
• ✅ Tag-based Retrieval - Get data by tags with statistics and grouping
• ✅ Whiteboard Communication - Messaging and collaboration
• ✅ Performance Optimization - Built-in caching and optimized queries

Quick Start

1. Install via NPM (Recommended)

Users can add this to their MCP client configuration with just one JSON snippet:

{
  "mcpServers": {
    "linq-workspace": {
      "command": "npx",
      "args": ["-y", "@arjun_01/linq-mcp-server"],
      "env": {
        "LINQ_API_KEY": "your-linq-api-key-here"
      }
    }
  }
}

2. Environment Variables

| Variable | Description | Required | |----------|-------------|----------| | LINQ_API_KEY | Your Linq workspace API key | ✅ Yes | | LINQ_API_URL | Custom API endpoint (optional) | ❌ No |

3. Get Your API Key

1. Visit the Linq web app
2. Go to Connected Apps section
3. Register your AI assistant
4. Copy the generated API key

Available Tools (8 Total)

Core Data Access

• list_workspaces - List all accessible workspaces
• read_workspace_data - Basic data retrieval with filtering
• search_workspace_data - Advanced semantic search with ranking
• get_data_by_tags - Tag-based retrieval with statistics

Whiteboard Communication

• write_to_whiteboard - Send messages to whiteboards
• read_whiteboard_messages - Read whiteboard conversations
• list_whiteboards - List available whiteboards
• get_workspace_info - Detailed workspace information

Example Usage

Advanced Search

// Search for specific content with filters
{
  "workspace_id": "ws_123",
  "search_query": "machine learning analysis",
  "content_types": ["text", "document"],
  "tag_filters": {
    "required_tags": ["data-science"],
    "exclude_tags": ["archived"]
  },
  "confidence_range": {"min": 0.8},
  "sort_by": "relevance",
  "fuzzy_search": true
}

Tag-based Retrieval

// Get data by tags with statistics
{
  "workspace_id": "ws_123",
  "tags": ["project-alpha", "research"],
  "tag_logic": "all",
  "include_tag_stats": true,
  "group_by_tags": true
}

Whiteboard Communication

// Send a message to the main whiteboard
{
  "workspace_id": "ws_123",
  "content": "Analysis complete. Found 15 relevant documents.",
  "target_whiteboard": "main",
  "message_type": "success"
}

Desktop App Integration

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "linq-workspace": {
      "command": "npx",
      "args": ["-y", "@arjun_01/linq-mcp-server"],
      "env": {
        "LINQ_API_KEY": "linq_your_api_key_here"
      }
    }
  }
}

Cursor IDE

Add to your MCP configuration:

{
  "mcpServers": {
    "linq": {
      "command": "npx",
      "args": ["-y", "@arjun_01/linq-mcp-server"],
      "env": {
        "LINQ_API_KEY": "linq_your_api_key_here"
      }
    }
  }
}

Other MCP Clients

This package works with any MCP-compatible client. Just use the NPX command approach.

Key Features

Zero Configuration

• Single JSON Setup: Copy-paste configuration
• No File Downloads: Everything handled via NPX
• Automatic Updates: Always get latest version

Advanced Search Capabilities

• Semantic Matching: Fuzzy search with relevance scoring
• Complex Filtering: Multi-dimensional data filtering
• Tag Intelligence: Smart tag-based data discovery

Security & Performance

• Workspace Isolation: Granular permission control
• Optimized Queries: Built-in caching and optimization
• Secure Authentication: API key-based access control

Version History

v4.0.0 - Simplified Edition

• 8 Core Tools: Focus on essential functionality
• Improved Performance: Streamlined codebase
• Better Reliability: Removed complex real-time features

v3.x - Full Featured Edition

• 13 tools including real-time collaboration
• Inter-app communication features
• Advanced presence tracking

Support

For questions or issues:

• Check the Linq web app documentation
• Verify your API key is correct
• Ensure your MCP client supports the tools you're using

License

MIT - see LICENSE file for details.