mcp-rule34 2.0.0 → 2.0.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.
Files changed (7) hide show
  1. package/CHANGELOG.md +11 -0
  2. package/PRIVACY.md +156 -0
  3. package/README.md +337 -306
  4. package/dist/index.js +1 -1
  5. package/dist/index.js.map +1 -1
  6. package/package.json +5 -1
  7. package/server.json +10 -2
package/CHANGELOG.md CHANGED
@@ -1,5 +1,16 @@
1
1
  # Changelog
2
2
 
3
+ ## 2.0.1
4
+
5
+ - **Every tool is documented, with its arguments and what its answer carries.**
6
+ The README is written for a person deciding whether to install and for a
7
+ program installing on its own, and a test holds both halves to what the server
8
+ registers.
9
+ - **The privacy policy travels in the package.** It states the hosts contacted,
10
+ what a request carries, what is held and for how long.
11
+ - **The manifest names every tool the server registers**, which a host reads
12
+ before installing anything.
13
+
3
14
  ## 2.0.0
4
15
 
5
16
  - **This server now needs node 24 or later.** Node 20 reached its end of
package/PRIVACY.md ADDED
@@ -0,0 +1,156 @@
1
+ # Privacy
2
+
3
+ This server collects nothing about you, and sends nothing to its author.
4
+
5
+ _[Version française](#confidentialité)_
6
+
7
+ ---
8
+
9
+ ## What this server is
10
+
11
+ `mcp-rule34` is a read-only client for [rule34.xxx](https://rule34.xxx). It runs on your
12
+ own machine, as a process your MCP host starts, and it speaks over stdio. It
13
+ listens on no port.
14
+
15
+ **This server sends credentials, because the site requires them.** rule34.xxx issues an API key per account, and its terms allow automated reading through the API alone. You supply `RULE34_USER_ID` and `RULE34_API_KEY`, and they travel to `api.rule34.xxx` on every request, which is the only place they go. They are read from the environment, held in memory for the life of the process, and written nowhere.
16
+
17
+ ## What leaves your machine, and where it goes
18
+
19
+ **2 hosts are contacted**, and nothing else.
20
+
21
+ | Host | What is read there |
22
+ | ---------------- | ------------------ |
23
+ | `rule34.xxx` | the site's pages |
24
+ | `api.rule34.xxx` | the site's API |
25
+
26
+ What a request carries:
27
+
28
+ | What | Why it is there |
29
+ | ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- |
30
+ | The question you asked | A search term or an identifier reaches the site as you wrote it. |
31
+ | A `User-Agent` | `mcp-rule34/<version> (+https://github.com/smeet666/mcp-rule34)`, so the site can reach a person about the traffic it receives. |
32
+ | Your IP address | Sent by your network to any host you contact, as with any web request. |
33
+ | Your rule34.xxx user id and API key | The site refuses an anonymous read of its API. They go to `api.rule34.xxx` and nowhere else. |
34
+
35
+ Your requests reach rule34.xxx. What is done with them there is governed by that site's own privacy policy, which this project does not control.
36
+
37
+ ## What is kept, and for how long
38
+
39
+ **Answers are held in memory only, and only while the server runs.** The cache is
40
+ a table in the process: it holds what was read so that reading the same page
41
+ twice costs one request instead of two. Closing the server empties it.
42
+
43
+ **Nothing is written to disk.** The server creates no file, no database and no
44
+ log file.
45
+
46
+ ## What is never collected
47
+
48
+ - No analytics, no telemetry, no usage counter.
49
+ - Nothing is sent to the author of this project or to any third party.
50
+ - No account, no profile, no identifier is created for you.
51
+ - Your questions are not stored, forwarded, or used to train anything.
52
+
53
+ ## Logs
54
+
55
+ The server writes diagnostics to **stderr**, where your MCP host decides what
56
+ becomes of them. `RULE34_LOG_LEVEL` governs how much is written and defaults to `error`. These lines stay on your machine.
57
+
58
+ ## The settings that change any of this
59
+
60
+ | Variable | What it changes |
61
+ | --------------------- | ---------------------------------------------------------------------------------------------------------------- |
62
+ | `RULE34_USER_AGENT` | Adds your own identifier in front of this project's, which stays appended so the site can always reach a person. |
63
+ | `RULE34_CACHE_TTL_MS` | How long an answer is held in memory. `0` turns the cache off. |
64
+ | `RULE34_LOG_LEVEL` | How much is written to stderr. |
65
+
66
+ ## Children
67
+
68
+ This server is a tool for developers and it is not directed at children.
69
+
70
+ ## Changes
71
+
72
+ A change to this policy travels in a release, and the changelog names it.
73
+
74
+ ## Contact
75
+
76
+ Open an issue on [the repository](https://github.com/smeet666/mcp-rule34/issues). For something exploitable,
77
+ follow [SECURITY.md](./SECURITY.md) instead.
78
+
79
+ ---
80
+
81
+ # Confidentialité
82
+
83
+ Ce serveur ne collecte rien sur vous et n'envoie rien à son auteur.
84
+
85
+ ## Ce qu'est ce serveur
86
+
87
+ `mcp-rule34` est un client en lecture seule pour [rule34.xxx](https://rule34.xxx). Il
88
+ tourne sur votre machine, comme un processus que votre hôte MCP démarre, et il
89
+ parle en stdio. Il n'écoute sur aucun port.
90
+
91
+ **Ce serveur envoie des identifiants, parce que le site les exige.** rule34.xxx délivre une clé d'API par compte, et ses conditions n'autorisent la lecture automatisée que par l'API. Vous fournissez `RULE34_USER_ID` et `RULE34_API_KEY`, qui voyagent vers `api.rule34.xxx` à chaque requête et ne vont nulle part ailleurs. Ils sont lus dans l'environnement, gardés en mémoire le temps du processus, et écrits nulle part.
92
+
93
+ ## Ce qui quitte votre machine, et où cela va
94
+
95
+ **2 hôtes sont joints**, et rien d'autre.
96
+
97
+ | Hôte | Ce qui y est lu |
98
+ | ---------------- | ----------------- |
99
+ | `rule34.xxx` | les pages du site |
100
+ | `api.rule34.xxx` | l'API du site |
101
+
102
+ Ce qu'une requête emporte :
103
+
104
+ | Quoi | Pourquoi |
105
+ | ----------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
106
+ | La question posée | Un terme de recherche ou un identifiant atteint le site tel que vous l'avez écrit. |
107
+ | Un `User-Agent` | `mcp-rule34/<version> (+https://github.com/smeet666/mcp-rule34)`, pour que le site puisse joindre une personne au sujet du trafic qu'il reçoit. |
108
+ | Votre adresse IP | Transmise par votre réseau à tout hôte que vous joignez, comme pour n'importe quelle requête web. |
109
+ | Votre identifiant et votre clé rule34.xxx | Le site refuse une lecture anonyme de son API. Ils vont vers `api.rule34.xxx` et nulle part ailleurs. |
110
+
111
+ Vos requêtes atteignent rule34.xxx. Ce qui en est fait là-bas relève de la politique de confidentialité de ce site, que ce projet ne contrôle pas.
112
+
113
+ ## Ce qui est conservé, et combien de temps
114
+
115
+ **Les réponses sont gardées en mémoire seulement, et seulement pendant que le
116
+ serveur tourne.** Le cache est une table dans le processus : il retient ce qui a
117
+ été lu pour que lire deux fois la même page coûte une requête plutôt que deux.
118
+ Fermer le serveur le vide.
119
+
120
+ **Rien n'est écrit sur le disque.** Le serveur ne crée aucun fichier, aucune base
121
+ et aucun journal.
122
+
123
+ ## Ce qui n'est jamais collecté
124
+
125
+ - Aucune analyse d'audience, aucune télémétrie, aucun compteur d'usage.
126
+ - Rien n'est envoyé à l'auteur de ce projet ni à un tiers.
127
+ - Aucun compte, aucun profil, aucun identifiant n'est créé pour vous.
128
+ - Vos questions ne sont ni stockées, ni transmises, ni utilisées pour entraîner
129
+ quoi que ce soit.
130
+
131
+ ## Les journaux
132
+
133
+ Le serveur écrit ses diagnostics sur **stderr**, où votre hôte MCP décide de ce
134
+ qu'ils deviennent. `RULE34_LOG_LEVEL` règle leur quantité et vaut `error` par défaut. Ces lignes restent sur votre machine.
135
+
136
+ ## Les réglages qui changent tout cela
137
+
138
+ | Variable | Ce qu'elle change |
139
+ | --------------------- | ------------------------------------------------------------------------------------------------------------------------ |
140
+ | `RULE34_USER_AGENT` | Ajoute votre identifiant devant celui du projet, qui reste accolé pour que le site puisse toujours joindre une personne. |
141
+ | `RULE34_CACHE_TTL_MS` | Combien de temps une réponse est gardée en mémoire. `0` éteint le cache. |
142
+ | `RULE34_LOG_LEVEL` | La quantité écrite sur stderr. |
143
+
144
+ ## Les enfants
145
+
146
+ Ce serveur est un outil pour développeurs et ne s'adresse pas aux enfants.
147
+
148
+ ## Les évolutions
149
+
150
+ Une modification de cette politique voyage dans une version, et le changelog la
151
+ nomme.
152
+
153
+ ## Contact
154
+
155
+ Ouvrez une issue sur [le dépôt](https://github.com/smeet666/mcp-rule34/issues). Pour quelque chose
156
+ d'exploitable, suivez plutôt [SECURITY.md](./SECURITY.md).