@chaindead/tooner_windows_arm64 0.0.6 → 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/README.md +137 -2
  2. package/package.json +1 -1
  3. package/tooner.exe +0 -0
package/README.md CHANGED
@@ -1,12 +1,145 @@
1
+ [![](https://badge.mcpx.dev?type=server 'MCP Server')](https://github.com/punkpeye/awesome-mcp-servers?tab=readme-ov-file#communication)
2
+ [![](https://img.shields.io/badge/OS_Agnostic-Works_Everywhere-purple)](https://github.com/chaindead/tooner?tab=readme-ov-file#installation)
3
+ [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
4
+ [![Visitors](https://api.visitorbadge.io/api/visitors?path=https%3A%2F%2Fgithub.com%2Fchaindead%2Ftooner&label=Visitors&labelColor=%23d9e3f0&countColor=%23697689&style=flat&labelStyle=none)](https://visitorbadge.io/status?path=https%3A%2F%2Fgithub.com%2Fchaindead%2Ftooner)
5
+
1
6
  # Tooner
2
7
 
3
8
  An MCP (Model Context Protocol) proxy that wraps MCP servers and converts JSON responses to [TOON format](https://toonformat.dev/) — a token-efficient alternative to JSON optimized for LLMs (~40% fewer tokens).
4
9
 
10
+ - [What it does](#what-it-does)
11
+ - [Installation](#installation)
12
+ - [Homebrew](#homebrew)
13
+ - [NPX](#npx)
14
+ - [From Releases](#from-releases)
15
+ - [MacOS](#macos)
16
+ - [Linux](#linux)
17
+ - [Windows](#windows)
18
+ - [From Source](#from-source)
19
+ - [Configure MCP (Cursor example)](#configure-mcp-cursor-example)
20
+
5
21
  ## What it does
6
22
 
7
23
  Tooner runs any MCP server as a subprocess and transparently proxies messages between the client (e.g. Cursor) and the server. When the server returns JSON in `tools/call` responses, Tooner converts that JSON to TOON before forwarding it to the client, reducing token usage while preserving the same data.
8
24
 
9
- ### Configure Cursor MCP
25
+ ## Installation
26
+
27
+ ### Homebrew
28
+
29
+ You can install a binary release on macOS/Linux using brew:
30
+
31
+ ```bash
32
+ # Install
33
+ brew install chaindead/tap/tooner
34
+
35
+ # Update
36
+ brew upgrade chaindead/tap/tooner
37
+ ```
38
+
39
+ ### NPX
40
+
41
+ You can run the latest version directly using npx (supports macOS, Linux, and Windows):
42
+
43
+ ```bash
44
+ npx -y @chaindead/tooner
45
+ ```
46
+
47
+ When using NPX [Configure MCP (Cursor example)](#configure-mcp-cursor-example) becomes:
48
+ ```json
49
+ {
50
+ "mcpServers": {
51
+ "telegram": {
52
+ "command": "npx",
53
+ "args": ["-y", "@chaindead/tooner", "memory-mcp-server-go"]
54
+ }
55
+ }
56
+ }
57
+ ```
58
+
59
+ ### From Releases
60
+
61
+ #### MacOS
62
+
63
+ <details>
64
+
65
+ > **Note:** The commands below install to `/usr/local/bin`. To install elsewhere, replace `/usr/local/bin` with your preferred directory in your PATH.
66
+
67
+ First, download the archive for your architecture:
68
+
69
+ ```bash
70
+ # For Intel Mac (x86_64)
71
+ curl -L -o tooner.tar.gz https://github.com/chaindead/tooner/releases/latest/download/tooner_Darwin_x86_64.tar.gz
72
+
73
+ # For Apple Silicon (M1/M2)
74
+ curl -L -o tooner.tar.gz https://github.com/chaindead/tooner/releases/latest/download/tooner_Darwin_arm64.tar.gz
75
+ ```
76
+
77
+ Then install the binary:
78
+
79
+ ```bash
80
+ # Extract the binary
81
+ sudo tar xzf tooner.tar.gz -C /usr/local/bin
82
+
83
+ # Make it executable
84
+ sudo chmod +x /usr/local/bin/tooner
85
+
86
+ # Clean up
87
+ rm tooner.tar.gz
88
+ ```
89
+ </details>
90
+
91
+ #### Linux
92
+ <details>
93
+
94
+ > **Note:** The commands below install to `/usr/local/bin`. To install elsewhere, replace `/usr/local/bin` with your preferred directory in your PATH.
95
+
96
+ First, download the archive for your architecture:
97
+
98
+ ```bash
99
+ # For x86_64 (64-bit)
100
+ curl -L -o tooner.tar.gz https://github.com/chaindead/tooner/releases/latest/download/tooner_Linux_x86_64.tar.gz
101
+
102
+ # For ARM64
103
+ curl -L -o tooner.tar.gz https://github.com/chaindead/tooner/releases/latest/download/tooner_Linux_arm64.tar.gz
104
+ ```
105
+
106
+ Then install the binary:
107
+
108
+ ```bash
109
+ # Extract the binary
110
+ sudo tar xzf tooner.tar.gz -C /usr/local/bin
111
+
112
+ # Make it executable
113
+ sudo chmod +x /usr/local/bin/tooner
114
+
115
+ # Clean up
116
+ rm tooner.tar.gz
117
+ ```
118
+ </details>
119
+
120
+ #### Windows
121
+
122
+ <details>
123
+
124
+ #### Windows
125
+ 1. Download the latest release for your architecture:
126
+ - [Windows x64](https://github.com/chaindead/tooner/releases/latest/download/tooner_Windows_x86_64.zip)
127
+ - [Windows ARM64](https://github.com/chaindead/tooner/releases/latest/download/tooner_Windows_arm64.zip)
128
+ 2. Extract the `.zip` file
129
+ 3. Add the extracted directory to your PATH or move `tooner.exe` to a directory in your PATH
130
+ </details>
131
+
132
+ ### From Source
133
+
134
+ Requirements:
135
+ - Go 1.26 or later
136
+ - GOBIN in PATH
137
+
138
+ ```bash
139
+ go install github.com/chaindead/tooner@latest
140
+ ```
141
+
142
+ ## Configure MCP (Cursor example)
10
143
 
11
144
  Add Tooner as a wrapper in `~/.cursor/mcp.json`, passing your MCP server as the first argument:
12
145
 
@@ -24,4 +157,6 @@ Add Tooner as a wrapper in `~/.cursor/mcp.json`, passing your MCP server as the
24
157
  }
25
158
  ```
26
159
 
27
- Replace `memory-mcp-server-go` with any MCP server binary in your PATH (e.g. `go-mcp-postgres`, `pocketbase-cursor-mcp`).
160
+ - Replace `memory-mcp-server-go` with any MCP server binary in your PATH (e.g. `go-mcp-postgres`).
161
+ - You can pass args and envs to MCP as always
162
+ - TOONER_LOG_PATH is optional
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@chaindead/tooner_windows_arm64",
3
- "version": "0.0.6",
3
+ "version": "0.1.0",
4
4
  "bin": {
5
5
  "tooner_windows_arm64": "tooner.exe"
6
6
  },
package/tooner.exe CHANGED
Binary file