pyxis-mcp 0.4.0 → 0.4.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/README.md +49 -2
- package/dist/server.js +1 -1
- package/dist/server.js.map +1 -1
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -108,13 +108,60 @@ A connection only reads the numbers you see in the dashboard, from every project
|
|
|
108
108
|
renews itself while it is used (each access token lasts an hour) and ends when you revoke it in the
|
|
109
109
|
dashboard, under Settings, Connected apps, or after 90 days without use; you keep up to ten. The
|
|
110
110
|
data Claude asks for goes from the Pyxis API to Anthropic, which handles it under its own terms.
|
|
111
|
-
Only Claude and Claude Code connect this way
|
|
112
|
-
|
|
111
|
+
Only Claude and Claude Code connect this way; other clients use an access token.
|
|
112
|
+
|
|
113
|
+
## Connect from other clients
|
|
114
|
+
|
|
115
|
+
A client that sends a header reaches the same address with an access token instead of signing in.
|
|
116
|
+
Create one in the dashboard (Settings, Access tokens), choose how long it lives, and revoke it there
|
|
117
|
+
when it is no longer needed. It reads the same projects as its admin, and only reads.
|
|
118
|
+
|
|
119
|
+
Cursor (`~/.cursor/mcp.json`), with the token in the `PYXIS_TOKEN` environment variable:
|
|
120
|
+
|
|
121
|
+
```json
|
|
122
|
+
{
|
|
123
|
+
"mcpServers": {
|
|
124
|
+
"pyxis": {
|
|
125
|
+
"url": "https://api.pyxis-analytics.dev/mcp",
|
|
126
|
+
"headers": { "Authorization": "Bearer ${env:PYXIS_TOKEN}" }
|
|
127
|
+
}
|
|
128
|
+
}
|
|
129
|
+
}
|
|
130
|
+
```
|
|
131
|
+
|
|
132
|
+
VS Code (`mcp.json`), which asks for the token once and keeps it out of the file:
|
|
133
|
+
|
|
134
|
+
```json
|
|
135
|
+
{
|
|
136
|
+
"inputs": [
|
|
137
|
+
{
|
|
138
|
+
"type": "promptString",
|
|
139
|
+
"id": "pyxis-token",
|
|
140
|
+
"description": "Pyxis access token",
|
|
141
|
+
"password": true
|
|
142
|
+
}
|
|
143
|
+
],
|
|
144
|
+
"servers": {
|
|
145
|
+
"pyxis": {
|
|
146
|
+
"type": "http",
|
|
147
|
+
"url": "https://api.pyxis-analytics.dev/mcp",
|
|
148
|
+
"headers": { "Authorization": "Bearer ${input:pyxis-token}" }
|
|
149
|
+
}
|
|
150
|
+
}
|
|
151
|
+
}
|
|
152
|
+
```
|
|
153
|
+
|
|
154
|
+
Claude Code, with a token instead of signing in:
|
|
113
155
|
|
|
114
156
|
```bash
|
|
115
157
|
claude mcp add --transport http pyxis https://api.pyxis-analytics.dev/mcp --header "Authorization: Bearer pyxis_at_…"
|
|
116
158
|
```
|
|
117
159
|
|
|
160
|
+
A client that only runs servers on the computer uses the package with the same token (see
|
|
161
|
+
[Run it on your computer](#run-it-on-your-computer)). ChatGPT cannot connect yet: its connectors
|
|
162
|
+
sign in only with OAuth and cannot send an access token, and the Pyxis OAuth server knows only
|
|
163
|
+
Claude and Claude Code.
|
|
164
|
+
|
|
118
165
|
## Configuration
|
|
119
166
|
|
|
120
167
|
| Variable | Required | Meaning |
|
package/dist/server.js
CHANGED
|
@@ -5,7 +5,7 @@ export const SERVER_NAME = 'pyxis';
|
|
|
5
5
|
export const INSTALL_GUIDE_URL = 'https://pyxis-analytics.dev/llms.txt';
|
|
6
6
|
export const SERVER_INSTRUCTIONS = "Pyxis is privacy-first product analytics: visits, page views, named events and the site's requests to its backend, with no cookies and no personal data. Start with list_projects for the project ids and each project's today, then ask for a range of dates. Every tool only reads. " +
|
|
7
7
|
'An empty list means no project was created yet, or none was shared with this person: projects are created in the Pyxis dashboard. ' +
|
|
8
|
-
`A project whose first_event_at is null has received nothing, so its site does not run the tracker yet. No tool here can install it
|
|
8
|
+
`A project whose first_event_at is null has received nothing, so its site does not run the tracker yet. No tool here can install it: the site's developers add the npm package pyxis-analytics, started with one of the public keys project_settings lists, as the install guide at ${INSTALL_GUIDE_URL} documents.`;
|
|
9
9
|
export const UNEXPECTED_ANSWER = 'The Pyxis API answered in a shape this server does not recognize. Update pyxis-mcp, or report it at https://github.com/samuelcsantana/pyxis-mcp/issues.';
|
|
10
10
|
const READ_ONLY = {
|
|
11
11
|
readOnlyHint: true,
|
package/dist/server.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGpE,OAAO,EACL,WAAW,EAGX,cAAc,EACd,iBAAiB,GAClB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C,MAAM,CAAC,MAAM,WAAW,GAAG,OAAO,CAAC;AAEnC,MAAM,CAAC,MAAM,iBAAiB,GAAG,sCAAsC,CAAC;AAExE,MAAM,CAAC,MAAM,mBAAmB,GAC9B,wRAAwR;IACxR,oIAAoI;IACpI,
|
|
1
|
+
{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "pyxis-mcp",
|
|
3
|
-
"version": "0.4.
|
|
3
|
+
"version": "0.4.1",
|
|
4
4
|
"description": "MCP server for Pyxis, privacy-first product analytics: lets an AI agent read your dashboard's numbers with a read-only token, locally over stdio or hosted over HTTP.",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"mcp",
|