mcp-metacritic 2.0.0 → 2.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 (10) hide show
  1. package/CHANGELOG.md +20 -0
  2. package/PRIVACY.md +160 -0
  3. package/README.md +398 -259
  4. package/dist/index.js +177 -79
  5. package/dist/index.js.map +1 -1
  6. package/dist/mc/client.d.ts +13 -3
  7. package/dist/mc/client.js +76 -26
  8. package/dist/mc/client.js.map +1 -1
  9. package/package.json +16 -11
  10. package/server.json +4 -4
package/CHANGELOG.md CHANGED
@@ -1,5 +1,25 @@
1
1
  # Changelog
2
2
 
3
+ ## 2.1.0
4
+
5
+ - **Node.js 24.22.1 or later**, inside the Node.js 24 line. The package, the
6
+ extension manifest and the image all declare it.
7
+ - **zod `^4.6.7`.** Below 4.6.6, zod can exhaust memory while
8
+ validating oversized constrained collections, and the range accepts none of
9
+ those versions.
10
+ - **Dependency floors:** `@modelcontextprotocol/sdk` `^1.32.2`.
11
+
12
+ ## 2.0.1
13
+
14
+ - **Every tool is documented, with its arguments and what its answer carries.**
15
+ The README is written for a person deciding whether to install and for a
16
+ program installing on its own, and a test holds both halves to what the server
17
+ registers.
18
+ - **The privacy policy travels in the package.** It states the hosts contacted,
19
+ what a request carries, what is held and for how long.
20
+ - **The manifest names every tool the server registers**, which a host reads
21
+ before installing anything.
22
+
3
23
  ## 2.0.0
4
24
 
5
25
  - **This server now needs node 24 or later.** Node 20 reached its end of
package/PRIVACY.md ADDED
@@ -0,0 +1,160 @@
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-metacritic` is a read-only client for [Metacritic](https://www.metacritic.com). 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
+ It needs no API key and no account, so there is no credential for it to hold and none for it to send.
16
+
17
+ ## What leaves your machine, and where it goes
18
+
19
+ **1 host is contacted**, and nothing else.
20
+
21
+ | Host | What is read there |
22
+ | ------------------------ | ------------------ |
23
+ | `backend.metacritic.com` | the site's own API |
24
+
25
+ `www.metacritic.com` appears in the links an answer carries, so a reader can open
26
+ the entry on the site. No request is sent there.
27
+
28
+ What a request carries:
29
+
30
+ | What | Why it is there |
31
+ | ---------------------- | --------------------------------------------------------------------------------------------------------------------------------------- |
32
+ | The question you asked | A search term or an identifier reaches the site as you wrote it. |
33
+ | A `User-Agent` | `mcp-metacritic v<version> (https://github.com/smeet666/mcp-metacritic)`, so the site can reach a person about the traffic it receives. |
34
+ | Your IP address | Sent by your network to any host you contact, as with any web request. |
35
+
36
+ Your requests reach Metacritic. What is done with them there is governed by that site's own privacy policy, which this project does not control.
37
+
38
+ ## What is kept, and for how long
39
+
40
+ **Answers are held in memory only, and only while the server runs.** The cache is
41
+ a table in the process: it holds what was read so that reading the same page
42
+ twice costs one request instead of two. Closing the server empties it.
43
+
44
+ **Nothing is written to disk.** The server creates no file, no database and no
45
+ log file.
46
+
47
+ ## What is never collected
48
+
49
+ - No analytics, no telemetry, no usage counter.
50
+ - Nothing is sent to the author of this project or to any third party.
51
+ - No account, no profile, no identifier is created for you.
52
+ - Your questions are not stored, forwarded, or used to train anything.
53
+
54
+ ## Logs
55
+
56
+ The server writes diagnostics to **stderr**, where your MCP host decides what
57
+ becomes of them. `MC_LOG_LEVEL` governs how much is written and defaults to `error`. These lines stay on your machine.
58
+
59
+ ## The settings that change any of this
60
+
61
+ | Variable | What it changes |
62
+ | ------------------------ | ---------------------------------------------------------------------------------------------------------------- |
63
+ | `MC_USER_AGENT` | Adds your own identifier in front of this project's, which stays appended so the site can always reach a person. |
64
+ | `MC_CACHE_TTL_MS` | How long a catalogue answer is held in memory. `0` turns that cache off. |
65
+ | `MC_SCORES_CACHE_TTL_MS` | How long a score or a review is held, which moves as reviews come in and so has a lifetime of its own. |
66
+ | `MC_LOG_LEVEL` | How much is written to stderr. |
67
+
68
+ ## Children
69
+
70
+ This server is a tool for developers and it is not directed at children.
71
+
72
+ ## Changes
73
+
74
+ A change to this policy travels in a release, and the changelog names it.
75
+
76
+ ## Contact
77
+
78
+ Open an issue on [the repository](https://github.com/smeet666/mcp-metacritic/issues). For something exploitable,
79
+ follow [SECURITY.md](./SECURITY.md) instead.
80
+
81
+ ---
82
+
83
+ # Confidentialité
84
+
85
+ Ce serveur ne collecte rien sur vous et n'envoie rien à son auteur.
86
+
87
+ ## Ce qu'est ce serveur
88
+
89
+ `mcp-metacritic` est un client en lecture seule pour [Metacritic](https://www.metacritic.com). Il
90
+ tourne sur votre machine, comme un processus que votre hôte MCP démarre, et il
91
+ parle en stdio. Il n'écoute sur aucun port.
92
+
93
+ Il ne demande ni clé d'API ni compte, donc il ne détient aucun identifiant et n'en envoie aucun.
94
+
95
+ ## Ce qui quitte votre machine, et où cela va
96
+
97
+ **1 hôte est joint**, et rien d'autre.
98
+
99
+ | Hôte | Ce qui y est lu |
100
+ | ------------------------ | --------------- |
101
+ | `backend.metacritic.com` | l'API du site |
102
+
103
+ `www.metacritic.com` figure dans les liens que porte une réponse, pour qu'un
104
+ lecteur ouvre la fiche sur le site. Aucune requête n'y est envoyée.
105
+
106
+ Ce qu'une requête emporte :
107
+
108
+ | Quoi | Pourquoi |
109
+ | ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
110
+ | La question posée | Un terme de recherche ou un identifiant atteint le site tel que vous l'avez écrit. |
111
+ | Un `User-Agent` | `mcp-metacritic v<version> (https://github.com/smeet666/mcp-metacritic)`, pour que le site puisse joindre une personne au sujet du trafic qu'il reçoit. |
112
+ | Votre adresse IP | Transmise par votre réseau à tout hôte que vous joignez, comme pour n'importe quelle requête web. |
113
+
114
+ Vos requêtes atteignent Metacritic. Ce qui en est fait là-bas relève de la politique de confidentialité de ce site, que ce projet ne contrôle pas.
115
+
116
+ ## Ce qui est conservé, et combien de temps
117
+
118
+ **Les réponses sont gardées en mémoire seulement, et seulement pendant que le
119
+ serveur tourne.** Le cache est une table dans le processus : il retient ce qui a
120
+ été lu pour que lire deux fois la même page coûte une requête plutôt que deux.
121
+ Fermer le serveur le vide.
122
+
123
+ **Rien n'est écrit sur le disque.** Le serveur ne crée aucun fichier, aucune base
124
+ et aucun journal.
125
+
126
+ ## Ce qui n'est jamais collecté
127
+
128
+ - Aucune analyse d'audience, aucune télémétrie, aucun compteur d'usage.
129
+ - Rien n'est envoyé à l'auteur de ce projet ni à un tiers.
130
+ - Aucun compte, aucun profil, aucun identifiant n'est créé pour vous.
131
+ - Vos questions ne sont ni stockées, ni transmises, ni utilisées pour entraîner
132
+ quoi que ce soit.
133
+
134
+ ## Les journaux
135
+
136
+ Le serveur écrit ses diagnostics sur **stderr**, où votre hôte MCP décide de ce
137
+ qu'ils deviennent. `MC_LOG_LEVEL` règle leur quantité et vaut `error` par défaut. Ces lignes restent sur votre machine.
138
+
139
+ ## Les réglages qui changent tout cela
140
+
141
+ | Variable | Ce qu'elle change |
142
+ | ------------------------ | ---------------------------------------------------------------------------------------------------------------------------- |
143
+ | `MC_USER_AGENT` | Ajoute votre identifiant devant celui du projet, qui reste accolé pour que le site puisse toujours joindre une personne. |
144
+ | `MC_CACHE_TTL_MS` | Combien de temps une réponse de catalogue est gardée en mémoire. `0` éteint ce cache. |
145
+ | `MC_SCORES_CACHE_TTL_MS` | Combien de temps une note ou une critique est gardée, ce qui bouge à mesure que les avis arrivent et a donc sa propre durée. |
146
+ | `MC_LOG_LEVEL` | La quantité écrite sur stderr. |
147
+
148
+ ## Les enfants
149
+
150
+ Ce serveur est un outil pour développeurs et ne s'adresse pas aux enfants.
151
+
152
+ ## Les évolutions
153
+
154
+ Une modification de cette politique voyage dans une version, et le changelog la
155
+ nomme.
156
+
157
+ ## Contact
158
+
159
+ Ouvrez une issue sur [le dépôt](https://github.com/smeet666/mcp-metacritic/issues). Pour quelque chose
160
+ d'exploitable, suivez plutôt [SECURITY.md](./SECURITY.md).