lcsa-mcp 0.1.0

MCP server for LCSA - exposes local context signals to AI tools
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124

# lcsa-mcp

MCP (Model Context Protocol) server for LCSA. Exposes local context signals to AI tools like Claude, Cursor, Windsurf, and others.

## Installation

```bash
cargo install lcsa-mcp
```

Or build from source:

```bash
git clone https://github.com/pranay1610/LCSA
cd LCSA
cargo build --release -p lcsa-mcp
```

## Usage

Run the server (stdio transport):

```bash
lcsa-mcp
```

### Configure Claude Desktop

Add to `~/.config/claude/mcp_servers.json`:

```json
{
  "lcsa": {
    "command": "lcsa-mcp"
  }
}
```

Or with full path:

```json
{
  "lcsa": {
    "command": "/path/to/lcsa-mcp"
  }
}
```

### Configure Cursor

Add to your MCP configuration:

```json
{
  "mcpServers": {
    "lcsa": {
      "command": "lcsa-mcp"
    }
  }
}
```

## MCP Resources

| URI | Description |
|-----|-------------|
| `lcsa://context/current` | Snapshot of all latest signals |
| `lcsa://signals/latest/clipboard` | Latest clipboard signal (metadata) |
| `lcsa://signals/latest/selection` | Latest selection signal |
| `lcsa://signals/latest/focus` | Latest focus signal |

## MCP Tools

| Tool | Description |
|------|-------------|
| `get_supported_signals` | Query which signal types are supported on this platform |
| `get_current_context` | Get a snapshot of all latest signals |
| `get_clipboard_content` | Get raw clipboard content (requires permission and reason) |

## Example Tool Responses

### get_current_context

```json
{
  "device": {
    "id": "abc123",
    "name": "workstation",
    "platform": "Linux"
  },
  "application": {
    "id": "lcsa-mcp",
    "name": "lcsa-mcp"
  },
  "supported_signals": ["clipboard", "selection", "focus"],
  "latest_signals": {
    "clipboard": {
      "content_type": "Text",
      "size_bytes": 42,
      "source_app": "firefox",
      "likely_sensitive": false,
      "likely_command": false
    }
  }
}
```

### get_clipboard_content

```json
{
  "preview": "Hello w...",
  "source_app": "firefox",
  "payload": "Hello world"
}
```

## Privacy

LCSA separates signal metadata from content. The `get_current_context` tool returns only metadata (content type, size, source app, sensitivity flags). Raw clipboard content requires explicit permission via `get_clipboard_content` with a stated reason.

## License

Apache-2.0