linear-mcp-fast 0.1.0__tar.gz

linear_mcp_fast-0.1.0/PKG-INFO

@@ -0,0 +1,160 @@
+Metadata-Version: 2.4
+Name: linear-mcp-fast
+Version: 0.1.0
+Summary: Fast MCP server for Linear - reads from Linear.app's local cache on macOS
+Author: everything-chalna
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/everything-chalna/linear-mcp-fast
+Project-URL: Repository, https://github.com/everything-chalna/linear-mcp-fast
+Project-URL: Issues, https://github.com/everything-chalna/linear-mcp-fast/issues
+Keywords: linear,mcp,cache,indexeddb,macos
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: MacOS
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: mcp>=1.0.0
+Requires-Dist: brotli>=1.0.0
+
+# linear-mcp-fast
+
+Fast, read-only MCP server for Linear that reads from Linear.app's local cache on macOS.
+
+**Why?**
+- **Instant**: No API calls, reads directly from local IndexedDB cache
+- **Offline**: Works without internet
+- **Lower context**: Smaller responses for AI assistants
+
+**Use with**: Official Linear MCP for write operations (comments, updates).
+
+## Installation
+
+```bash
+pip install linear-mcp-fast
+# or
+uv pip install linear-mcp-fast
+```
+
+## Setup
+
+### Claude Code
+
+```bash
+# 1. Add linear-mcp-fast (reads from local cache)
+claude mcp add linear-fast -- uvx linear-mcp-fast
+
+# 2. Add official Linear MCP (for writes)
+claude mcp add --transport http linear https://mcp.linear.app/mcp
+```
+
+Now you have:
+- `linear-fast` → Fast reads from local cache
+- `linear` → Writes (comments, updates)
+
+### Claude Desktop
+
+Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "linear-fast": {
+      "command": "uvx",
+      "args": ["linear-mcp-fast"]
+    },
+    "linear": {
+      "command": "npx",
+      "args": ["-y", "mcp-remote", "https://mcp.linear.app/mcp"]
+    }
+  }
+}
+```
+
+### Cursor / VS Code
+
+```json
+{
+  "mcpServers": {
+    "linear-fast": {
+      "command": "uvx",
+      "args": ["linear-mcp-fast"]
+    },
+    "linear": {
+      "command": "npx",
+      "args": ["-y", "mcp-remote", "https://mcp.linear.app/mcp"]
+    }
+  }
+}
+```
+
+---
+
+## Prerequisites
+
+- **macOS** (Linear.app stores cache in `~/Library/Application Support/Linear/`)
+- **Linear.app** installed and opened at least once
+
+---
+
+## Available Tools
+
+### Reading (linear-fast)
+
+| Tool | Description |
+|------|-------------|
+| `list_issues` | List issues with filters (assignee, team, state, priority) |
+| `get_issue` | Get issue details with comments |
+| `search_issues` | Search issues by title |
+| `get_my_issues` | Get issues assigned to a user |
+| `list_teams` | List all teams |
+| `list_projects` | List all projects |
+| `get_summary` | Get cache summary |
+
+### Writing (official Linear MCP)
+
+Use the official Linear MCP (`linear`) for:
+- Creating/updating issues
+- Adding comments
+- Changing status
+
+---
+
+## Troubleshooting
+
+### "Linear database not found"
+
+Linear.app needs to be installed and opened at least once:
+```bash
+ls ~/Library/Application\ Support/Linear/IndexedDB/
+```
+
+### Data seems stale
+
+Local cache is updated when Linear.app syncs. Open Linear.app to refresh.
+
+---
+
+## How It Works
+
+```
+Linear.app (Electron)
+    ↓ syncs to
+IndexedDB (LevelDB format)
+~/Library/Application Support/Linear/IndexedDB/...
+    ↓ read by
+linear-mcp-fast
+    ↓ provides
+Fast read-only access to issues, users, teams, comments
+```
+
+---
+
+## License
+
+MIT

linear_mcp_fast-0.1.0/README.md

@@ -0,0 +1,136 @@
+# linear-mcp-fast
+
+Fast, read-only MCP server for Linear that reads from Linear.app's local cache on macOS.
+
+**Why?**
+- **Instant**: No API calls, reads directly from local IndexedDB cache
+- **Offline**: Works without internet
+- **Lower context**: Smaller responses for AI assistants
+
+**Use with**: Official Linear MCP for write operations (comments, updates).
+
+## Installation
+
+```bash
+pip install linear-mcp-fast
+# or
+uv pip install linear-mcp-fast
+```
+
+## Setup
+
+### Claude Code
+
+```bash
+# 1. Add linear-mcp-fast (reads from local cache)
+claude mcp add linear-fast -- uvx linear-mcp-fast
+
+# 2. Add official Linear MCP (for writes)
+claude mcp add --transport http linear https://mcp.linear.app/mcp
+```
+
+Now you have:
+- `linear-fast` → Fast reads from local cache
+- `linear` → Writes (comments, updates)
+
+### Claude Desktop
+
+Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "linear-fast": {
+      "command": "uvx",
+      "args": ["linear-mcp-fast"]
+    },
+    "linear": {
+      "command": "npx",
+      "args": ["-y", "mcp-remote", "https://mcp.linear.app/mcp"]
+    }
+  }
+}
+```
+
+### Cursor / VS Code
+
+```json
+{
+  "mcpServers": {
+    "linear-fast": {
+      "command": "uvx",
+      "args": ["linear-mcp-fast"]
+    },
+    "linear": {
+      "command": "npx",
+      "args": ["-y", "mcp-remote", "https://mcp.linear.app/mcp"]
+    }
+  }
+}
+```
+
+---
+
+## Prerequisites
+
+- **macOS** (Linear.app stores cache in `~/Library/Application Support/Linear/`)
+- **Linear.app** installed and opened at least once
+
+---
+
+## Available Tools
+
+### Reading (linear-fast)
+
+| Tool | Description |
+|------|-------------|
+| `list_issues` | List issues with filters (assignee, team, state, priority) |
+| `get_issue` | Get issue details with comments |
+| `search_issues` | Search issues by title |
+| `get_my_issues` | Get issues assigned to a user |
+| `list_teams` | List all teams |
+| `list_projects` | List all projects |
+| `get_summary` | Get cache summary |
+
+### Writing (official Linear MCP)
+
+Use the official Linear MCP (`linear`) for:
+- Creating/updating issues
+- Adding comments
+- Changing status
+
+---
+
+## Troubleshooting
+
+### "Linear database not found"
+
+Linear.app needs to be installed and opened at least once:
+```bash
+ls ~/Library/Application\ Support/Linear/IndexedDB/
+```
+
+### Data seems stale
+
+Local cache is updated when Linear.app syncs. Open Linear.app to refresh.
+
+---
+
+## How It Works
+
+```
+Linear.app (Electron)
+    ↓ syncs to
+IndexedDB (LevelDB format)
+~/Library/Application Support/Linear/IndexedDB/...
+    ↓ read by
+linear-mcp-fast
+    ↓ provides
+Fast read-only access to issues, users, teams, comments
+```
+
+---
+
+## License
+
+MIT

linear_mcp_fast-0.1.0/pyproject.toml

@@ -0,0 +1,54 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "linear-mcp-fast"
+version = "0.1.0"
+description = "Fast MCP server for Linear - reads from Linear.app's local cache on macOS"
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.10"
+authors = [
+    { name = "everything-chalna" }
+]
+keywords = ["linear", "mcp", "cache", "indexeddb", "macos"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "Operating System :: MacOS",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+]
+dependencies = [
+    "mcp>=1.0.0",
+    "brotli>=1.0.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/everything-chalna/linear-mcp-fast"
+Repository = "https://github.com/everything-chalna/linear-mcp-fast"
+Issues = "https://github.com/everything-chalna/linear-mcp-fast/issues"
+
+[project.scripts]
+linear-mcp-fast = "linear_mcp_fast:main"
+
+[tool.setuptools.packages.find]
+where = ["src", "vendor/ccl_chromium_reader", "vendor/ccl_simplesnappy"]
+
+[tool.setuptools.package-dir]
+"" = "src"
+"ccl_chromium_reader" = "vendor/ccl_chromium_reader/ccl_chromium_reader"
+"ccl_chromium_reader.serialization_formats" = "vendor/ccl_chromium_reader/ccl_chromium_reader/serialization_formats"
+"ccl_chromium_reader.storage_formats" = "vendor/ccl_chromium_reader/ccl_chromium_reader/storage_formats"
+"ccl_simplesnappy" = "vendor/ccl_simplesnappy/ccl_simplesnappy"
+
+[dependency-groups]
+dev = [
+    "pytest>=7.0.0",
+    "ruff>=0.1.0",
+]

linear_mcp_fast-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

linear_mcp_fast-0.1.0/src/linear_mcp_fast/__init__.py

@@ -0,0 +1,8 @@
+"""
+linear-mcp-fast - Fast MCP server for Linear via local cache.
+"""
+
+from .server import main
+
+__version__ = "0.1.0"
+__all__ = ["main"]

linear_mcp_fast-0.1.0/src/linear_mcp_fast/__main__.py

@@ -0,0 +1,6 @@
+"""Entry point for running linear-mcp-fast as a module."""
+
+from .server import main
+
+if __name__ == "__main__":
+    main()