@iistools/grove-mcp 0.0.0-stage → 0.1.1
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.
- package/LICENSE +21 -0
- package/README.md +69 -2
- package/THIRD_PARTY_NOTICES.txt +810 -0
- package/grove-mcp.js +71 -0
- package/package.json +17 -4
package/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 IIS New Media Labs e.U.
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
package/README.md
CHANGED
|
@@ -1,3 +1,70 @@
|
|
|
1
|
-
#
|
|
1
|
+
# @iistools/grove-mcp
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
An [MCP](https://modelcontextprotocol.io) server for [Grove](https://grove.iis.tools),
|
|
4
|
+
the RSS feed service. It lets an agent (Claude Code, Claude Desktop, Cursor) read your
|
|
5
|
+
news, manage your feeds, engage with articles and discover sources.
|
|
6
|
+
|
|
7
|
+
## Install
|
|
8
|
+
|
|
9
|
+
Add one entry to your MCP host config (`mcp.json`, `claude_desktop_config.json`):
|
|
10
|
+
|
|
11
|
+
```json
|
|
12
|
+
{
|
|
13
|
+
"mcpServers": {
|
|
14
|
+
"grove": { "command": "npx", "args": ["-y", "@iistools/grove-mcp"] }
|
|
15
|
+
}
|
|
16
|
+
}
|
|
17
|
+
```
|
|
18
|
+
|
|
19
|
+
Claude Code, from a terminal:
|
|
20
|
+
|
|
21
|
+
```bash
|
|
22
|
+
claude mcp add grove -- npx -y @iistools/grove-mcp
|
|
23
|
+
```
|
|
24
|
+
|
|
25
|
+
Node 20 or newer is required. There is no setup step: the first Grove tool call opens a
|
|
26
|
+
sign-in with your account, and the server keeps the session for later calls.
|
|
27
|
+
|
|
28
|
+
## Example prompts
|
|
29
|
+
|
|
30
|
+
Paste any of these into your AI once Grove is attached. The first time it reads
|
|
31
|
+
your feeds, the server asks you to sign in. A longer list (16 prompts, with tips)
|
|
32
|
+
is on the "More examples" page in Grove under Settings.
|
|
33
|
+
|
|
34
|
+
1. **Morning briefing, no side effects.** "Give me a briefing of my unread Grove
|
|
35
|
+
articles: the ten most important stories, one line each with the source. Do
|
|
36
|
+
not open full articles and do not mark anything read; use the summaries only."
|
|
37
|
+
2. **Match against my own reactions.** "Look at the articles I have liked and
|
|
38
|
+
bookmarked in Grove, describe my interests in three bullets, then go through
|
|
39
|
+
today's unread and tell me which five fit those interests best and why."
|
|
40
|
+
3. **Back from a break.** "I was away for ten days. Page through all my unread
|
|
41
|
+
Grove articles (keep going until there are none left), drop duplicates covering
|
|
42
|
+
the same event, and give me: five things I must know, ten worth a glance, and
|
|
43
|
+
the rest as a count per source. Then ask me whether to mark the "rest" as read."
|
|
44
|
+
4. **Find, preview, then follow.** "Find me five good feeds about woodworking in
|
|
45
|
+
German. For each, show the preview (latest titles, how often it posts). Do not
|
|
46
|
+
subscribe yet; I will pick."
|
|
47
|
+
|
|
48
|
+
## Before you start
|
|
49
|
+
|
|
50
|
+
- **Opening a full article marks it read.** Say "summaries only" to keep your
|
|
51
|
+
unread list intact, and ask for the full text only for the few that matter.
|
|
52
|
+
- **Article text is third-party content.** A feed can carry text written to steer
|
|
53
|
+
an assistant. Grove marks the tools that change things (follow, unfollow, group
|
|
54
|
+
edits, reactions) so your host asks before running them: keep those
|
|
55
|
+
confirmations on and do not choose "always allow" for them. Reading tools can be
|
|
56
|
+
auto-allowed.
|
|
57
|
+
- **Review the list before a bulk action.** "Mark 400 articles read" and
|
|
58
|
+
"unsubscribe these six" are one step each; have your AI show the list first.
|
|
59
|
+
- **Reactions are your taste signal:** prompts like "match against my reactions"
|
|
60
|
+
read them. Your AI should like, bookmark or mark read only when you ask.
|
|
61
|
+
- **Open only sign-in links you just triggered.** The server opens the sign-in page
|
|
62
|
+
in your browser itself; when it cannot, the first call returns a link to open in a
|
|
63
|
+
browser on the computer running the server, and whoever opens it first within five
|
|
64
|
+
minutes decides which account the server is signed in as.
|
|
65
|
+
- Downloading all your Grove data and deleting it stay in the `grove` command-line
|
|
66
|
+
tool and the web app; your AI can do neither.
|
|
67
|
+
|
|
68
|
+
## License
|
|
69
|
+
|
|
70
|
+
MIT. Third-party licenses are in `THIRD_PARTY_NOTICES.txt`.
|