nana800-mcp-server 1.3.0 → 1.4.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.
- package/README.md +5 -0
- package/dist/index.js +39 -4
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -124,6 +124,10 @@ MCP_API_KEY=your_api_key npx -y nana800-mcp-server
|
|
|
124
124
|
|
|
125
125
|
An ID passed in a tool call always wins over the default. Every API request has a 30 second timeout.
|
|
126
126
|
|
|
127
|
+
### 🏷️ What the server tells nana800 about requests
|
|
128
|
+
|
|
129
|
+
Every request carries `x-nana-client: mcp`, `x-nana-client-version` (the package version), the name and version of the AI client from the MCP connection (`x-nana-ai-client`, `x-nana-ai-client-version`, for example `claude-ai`, `cursor-vscode`), the tool that made the request (`x-nana-mcp-tool`) and the User-Agent `nana800-mcp-server/<version>`. nana800 uses them only to count how people work with the platform through MCP, the web app and the API. No prompts or tool results are sent.
|
|
130
|
+
|
|
127
131
|
## 🧰 Tools
|
|
128
132
|
|
|
129
133
|
### Projects
|
|
@@ -317,6 +321,7 @@ curl --compressed -o export.csv "<download_url>"
|
|
|
317
321
|
- 🔑 Ключ API: [cloud.nana800.io/settings](https://cloud.nana800.io/settings), его нужно передать в переменной `MCP_API_KEY`
|
|
318
322
|
- 🚀 Запуск: `npx -y nana800-mcp-server`, готовые настройки для клиентов выше в разделе Quick start
|
|
319
323
|
- 🖥️ Сервер работает на вашем компьютере и ходит в API nana800 от имени владельца ключа
|
|
324
|
+
- 🏷️ Каждый запрос помечен как сделанный через MCP: версия пакета, имя ИИ-клиента (Claude, Cursor и другие) и имя инструмента. По этим меткам nana800 считает, сколько работают через MCP, кабинет и API. Тексты запросов к ИИ и ответы инструментов не передаются
|
|
320
325
|
- 📈 Графики и дашборды: попросите, например, «построй воронку от просмотра до покупки за 30 дней» или «собери дашборд сайта из трёх графиков и включи публичную ссылку». Ассистент сам найдёт события, проверит цифры предпросмотром, сохранит графики, разложит их на дашборде и пришлёт ссылки на кабинет и публичную страницу
|
|
321
326
|
- ⚠️ Инструменты удаления (`project_delete`, `scheme_delete`, `node_delete` и другие) необратимы
|
|
322
327
|
- 📚 Документация: [nana800.gitbook.io/doc](https://nana800.gitbook.io/doc)
|
package/dist/index.js
CHANGED
|
@@ -4,15 +4,15 @@
|
|
|
4
4
|
import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
|
|
5
5
|
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
|
|
6
6
|
|
|
7
|
-
// src/tools/project.tools.ts
|
|
8
|
-
import { z } from "zod";
|
|
9
|
-
|
|
10
7
|
// src/api-client.ts
|
|
8
|
+
import { AsyncLocalStorage } from "node:async_hooks";
|
|
11
9
|
var API_BASE_URL = (process.env.MCP_API_URL || "https://api.nana800.io").replace(/\/+$/, "");
|
|
12
10
|
var ANALYTICS_API_BASE_URL = (process.env.MCP_ANALYTICS_API_URL || "https://api.analytics.nana800.io").replace(/\/+$/, "");
|
|
13
11
|
var API_KEY_HEADER = "x-nana-api-key";
|
|
14
12
|
var REQUEST_TIMEOUT_MS = 3e4;
|
|
15
13
|
var MAX_ERROR_TEXT_LENGTH = 2e3;
|
|
14
|
+
var MAX_CLIENT_HEADER_LENGTH = 100;
|
|
15
|
+
var PACKAGE_NAME = "nana800-mcp-server";
|
|
16
16
|
var DEFAULT_PROJECT_ID = process.env.MCP_PROJECT_ID || "";
|
|
17
17
|
var DEFAULT_SCHEME_ID = process.env.MCP_SCHEME_ID || "";
|
|
18
18
|
var DEFAULT_ANALYTICS_ORG_ID = process.env.MCP_ANALYTICS_ORG_ID || "";
|
|
@@ -37,6 +37,28 @@ var getAnalyticsOrgId = (providedId) => {
|
|
|
37
37
|
}
|
|
38
38
|
return id;
|
|
39
39
|
};
|
|
40
|
+
var toolNameStorage = new AsyncLocalStorage();
|
|
41
|
+
var getClientInfo = () => void 0;
|
|
42
|
+
var runWithToolName = (toolName, handler) => toolNameStorage.run(toolName, handler);
|
|
43
|
+
var setClientInfoGetter = (getter) => {
|
|
44
|
+
getClientInfo = getter;
|
|
45
|
+
};
|
|
46
|
+
var toHeaderValue = (value) => String(value || "").replace(/[^\x20-\x7E]/g, "").trim().slice(0, MAX_CLIENT_HEADER_LENGTH);
|
|
47
|
+
var getClientHeaders = () => {
|
|
48
|
+
const clientInfo = getClientInfo();
|
|
49
|
+
const aiClient = toHeaderValue(clientInfo?.name);
|
|
50
|
+
const aiClientVersion = toHeaderValue(clientInfo?.version);
|
|
51
|
+
const toolName = toHeaderValue(toolNameStorage.getStore());
|
|
52
|
+
const headers = {
|
|
53
|
+
"x-nana-client": "mcp",
|
|
54
|
+
"x-nana-client-version": "1.4.0",
|
|
55
|
+
"User-Agent": `${PACKAGE_NAME}/${"1.4.0"} (node ${process.version}${aiClient ? `; ${aiClient}` : ""})`
|
|
56
|
+
};
|
|
57
|
+
if (aiClient) headers["x-nana-ai-client"] = aiClient;
|
|
58
|
+
if (aiClientVersion) headers["x-nana-ai-client-version"] = aiClientVersion;
|
|
59
|
+
if (toolName) headers["x-nana-mcp-tool"] = toolName;
|
|
60
|
+
return headers;
|
|
61
|
+
};
|
|
40
62
|
var apiPath = (strings, ...values) => {
|
|
41
63
|
return strings.reduce((path, part, index) => path + part + (index < values.length ? encodeURIComponent(values[index]) : ""), "");
|
|
42
64
|
};
|
|
@@ -78,6 +100,7 @@ var ApiClient = class {
|
|
|
78
100
|
const response = await fetch(url.toString(), {
|
|
79
101
|
method,
|
|
80
102
|
headers: {
|
|
103
|
+
...getClientHeaders(),
|
|
81
104
|
[API_KEY_HEADER]: this.apiKey,
|
|
82
105
|
"Content-Type": "application/json"
|
|
83
106
|
},
|
|
@@ -124,6 +147,7 @@ var getAnalyticsApiClient = () => {
|
|
|
124
147
|
};
|
|
125
148
|
|
|
126
149
|
// src/tools/project.tools.ts
|
|
150
|
+
import { z } from "zod";
|
|
127
151
|
var registerProjectTools = (server) => {
|
|
128
152
|
server.tool(
|
|
129
153
|
"project_create",
|
|
@@ -2064,7 +2088,16 @@ var registerAnalyticsChartTools = (server) => {
|
|
|
2064
2088
|
|
|
2065
2089
|
// src/index.ts
|
|
2066
2090
|
var SERVER_NAME = "nana800-mcp-server";
|
|
2067
|
-
var SERVER_VERSION = "1.
|
|
2091
|
+
var SERVER_VERSION = "1.4.0";
|
|
2092
|
+
var tagRequestsWithToolNames = (server) => {
|
|
2093
|
+
const registerTool = server.tool.bind(server);
|
|
2094
|
+
server.tool = ((...args) => {
|
|
2095
|
+
const toolName = String(args[0]);
|
|
2096
|
+
const handler = args[args.length - 1];
|
|
2097
|
+
const taggedArgs = [...args.slice(0, -1), (...handlerArgs) => runWithToolName(toolName, () => handler(...handlerArgs))];
|
|
2098
|
+
return registerTool(...taggedArgs);
|
|
2099
|
+
});
|
|
2100
|
+
};
|
|
2068
2101
|
var main = async () => {
|
|
2069
2102
|
const apiKey = process.env.MCP_API_KEY;
|
|
2070
2103
|
if (!apiKey) {
|
|
@@ -2076,6 +2109,8 @@ var main = async () => {
|
|
|
2076
2109
|
name: SERVER_NAME,
|
|
2077
2110
|
version: SERVER_VERSION
|
|
2078
2111
|
});
|
|
2112
|
+
setClientInfoGetter(() => server.server.getClientVersion());
|
|
2113
|
+
tagRequestsWithToolNames(server);
|
|
2079
2114
|
registerProjectTools(server);
|
|
2080
2115
|
registerSchemeTools(server);
|
|
2081
2116
|
registerNodeTools(server);
|
package/package.json
CHANGED