easybill-mcp 1.0.1 → 1.2.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 (72) hide show
  1. package/README.md +293 -72
  2. package/dist/constants.d.ts +2 -1
  3. package/dist/constants.js +18 -1
  4. package/dist/constants.js.map +1 -1
  5. package/dist/hosted/accounts.d.ts +13 -0
  6. package/dist/hosted/accounts.js +70 -0
  7. package/dist/hosted/accounts.js.map +1 -0
  8. package/dist/hosted/config.d.ts +73 -0
  9. package/dist/hosted/config.js +200 -0
  10. package/dist/hosted/config.js.map +1 -0
  11. package/dist/hosted/http.d.ts +23 -0
  12. package/dist/hosted/http.js +524 -0
  13. package/dist/hosted/http.js.map +1 -0
  14. package/dist/hosted/pages.d.ts +22 -0
  15. package/dist/hosted/pages.js +130 -0
  16. package/dist/hosted/pages.js.map +1 -0
  17. package/dist/hosted/provider.d.ts +54 -0
  18. package/dist/hosted/provider.js +190 -0
  19. package/dist/hosted/provider.js.map +1 -0
  20. package/dist/hosted/store.d.ts +119 -0
  21. package/dist/hosted/store.js +254 -0
  22. package/dist/hosted/store.js.map +1 -0
  23. package/dist/hosted/upstream.d.ts +68 -0
  24. package/dist/hosted/upstream.js +280 -0
  25. package/dist/hosted/upstream.js.map +1 -0
  26. package/dist/index.d.ts +5 -1
  27. package/dist/index.js +19 -24
  28. package/dist/index.js.map +1 -1
  29. package/dist/instructions.d.ts +1 -1
  30. package/dist/instructions.js +16 -1
  31. package/dist/instructions.js.map +1 -1
  32. package/dist/server.d.ts +26 -0
  33. package/dist/server.js +47 -0
  34. package/dist/server.js.map +1 -0
  35. package/dist/services/client.d.ts +43 -4
  36. package/dist/services/client.js +35 -9
  37. package/dist/services/client.js.map +1 -1
  38. package/dist/services/format.d.ts +17 -4
  39. package/dist/services/format.js.map +1 -1
  40. package/dist/tools/catalog.d.ts +2 -2
  41. package/dist/tools/catalog.js.map +1 -1
  42. package/dist/tools/crud.d.ts +2 -2
  43. package/dist/tools/crud.js.map +1 -1
  44. package/dist/tools/customers.d.ts +2 -2
  45. package/dist/tools/customers.js +12 -4
  46. package/dist/tools/customers.js.map +1 -1
  47. package/dist/tools/documents.d.ts +2 -2
  48. package/dist/tools/documents.js +73 -43
  49. package/dist/tools/documents.js.map +1 -1
  50. package/dist/tools/files-io.d.ts +44 -0
  51. package/dist/tools/files-io.js +173 -0
  52. package/dist/tools/files-io.js.map +1 -0
  53. package/dist/tools/files.d.ts +2 -2
  54. package/dist/tools/files.js +9 -27
  55. package/dist/tools/files.js.map +1 -1
  56. package/dist/tools/finance.d.ts +2 -2
  57. package/dist/tools/finance.js.map +1 -1
  58. package/dist/tools/incoming.d.ts +11 -0
  59. package/dist/tools/incoming.js +222 -0
  60. package/dist/tools/incoming.js.map +1 -0
  61. package/dist/tools/meta.d.ts +2 -2
  62. package/dist/tools/meta.js +14 -6
  63. package/dist/tools/meta.js.map +1 -1
  64. package/dist/tools/registry.d.ts +40 -9
  65. package/dist/tools/registry.js +75 -12
  66. package/dist/tools/registry.js.map +1 -1
  67. package/dist/tools/search.d.ts +9 -8
  68. package/dist/tools/search.js +49 -17
  69. package/dist/tools/search.js.map +1 -1
  70. package/dist/tools/work.d.ts +2 -2
  71. package/dist/tools/work.js.map +1 -1
  72. package/package.json +16 -2
@@ -0,0 +1,73 @@
1
+ /**
2
+ * Configuration for hosted (HTTP + OAuth) mode.
3
+ *
4
+ * Hosted mode serves one MCP endpoint for a whole company. Each person connects
5
+ * the easybill accounts listed in the tenant file with their own easybill login
6
+ * (easybill's OAuth); nobody handles API keys.
7
+ */
8
+ export declare function defaultScopes(writes: boolean): string[];
9
+ export interface TenantConfig {
10
+ /** Slug used as the `account` argument, e.g. "acme". */
11
+ id: string;
12
+ /** Shown on the connect page and to the model. */
13
+ name: string;
14
+ /** Allow create/update/delete tools against this account. */
15
+ writes: boolean;
16
+ /** Client-side throttle, shared by everyone using this account. */
17
+ rateLimitPerMinute: number;
18
+ /** OAuth scopes requested from easybill. */
19
+ scopes: string[];
20
+ /**
21
+ * Optional check that the person logged into the right easybill account:
22
+ * every listed access-token claim must equal (or be one of) the given value(s).
23
+ * Without it, any easybill login is accepted for this tenant.
24
+ */
25
+ match?: Record<string, string | number | (string | number)[]>;
26
+ }
27
+ export interface HostedConfig {
28
+ /** Public base URL, e.g. https://easybill-mcp.example.com. The MCP endpoint is <publicUrl>/mcp. */
29
+ publicUrl: URL;
30
+ mcpUrl: URL;
31
+ host: string;
32
+ port: number;
33
+ /** Encrypts stored easybill tokens and signs the browser cookie. */
34
+ secret: string;
35
+ dbPath: string;
36
+ tenants: TenantConfig[];
37
+ /**
38
+ * How people connect an easybill account:
39
+ * - "apikey" (default): they paste their personal easybill API key.
40
+ * - "oauth": they log in through easybill's OAuth. easybill only allows this
41
+ * for OAuth clients it has issued (dynamic registration is allowlisted).
42
+ */
43
+ connectMode: "apikey" | "oauth";
44
+ upstream: {
45
+ /** easybill's OAuth issuer; endpoints are discovered from its metadata. */
46
+ issuer: string;
47
+ clientId?: string;
48
+ clientSecret?: string;
49
+ };
50
+ /**
51
+ * Cloudflare Access in front of the connect pages: when set, /connect/* only
52
+ * answers requests carrying a valid Access token for this application.
53
+ */
54
+ cloudflareAccess?: {
55
+ issuer: string;
56
+ audience: string;
57
+ };
58
+ /**
59
+ * Icon served as favicon and announced in the MCP server info, read from a
60
+ * file outside the image (e.g. a Coolify file mount). claude.ai shows the
61
+ * domain's favicon next to a custom connector.
62
+ */
63
+ icon?: {
64
+ path: string;
65
+ mimeType: string;
66
+ extension: "svg" | "png" | "ico";
67
+ };
68
+ /** Lifetime of the access tokens this server issues to MCP clients. */
69
+ accessTokenTtlSeconds: number;
70
+ /** Lifetime of the refresh tokens this server issues to MCP clients. */
71
+ refreshTokenTtlSeconds: number;
72
+ }
73
+ export declare function loadHostedConfig(env?: NodeJS.ProcessEnv): HostedConfig;
@@ -0,0 +1,200 @@
1
+ /**
2
+ * Configuration for hosted (HTTP + OAuth) mode.
3
+ *
4
+ * Hosted mode serves one MCP endpoint for a whole company. Each person connects
5
+ * the easybill accounts listed in the tenant file with their own easybill login
6
+ * (easybill's OAuth); nobody handles API keys.
7
+ */
8
+ import { readFileSync } from "node:fs";
9
+ /**
10
+ * easybill plans with REST API access and their request limits (easybill.de/preise).
11
+ * PLUS and BUSINESS are the former names, still named in easybill's API docs.
12
+ */
13
+ const PLAN_LIMITS = { PROFESSIONAL: 10, PREMIUM: 60, PLUS: 10, BUSINESS: 60 };
14
+ /** Plans without REST API access. */
15
+ const PLANS_WITHOUT_API = new Set(["FREE", "STARTER"]);
16
+ /**
17
+ * Scopes requested from easybill, per resource the tools use. `stocks` has no
18
+ * scope of its own in easybill's list; it travels with `position`.
19
+ */
20
+ const RESOURCE_SCOPES = [
21
+ "customer",
22
+ "contact",
23
+ "customer-group",
24
+ "document",
25
+ "document-payment",
26
+ "position",
27
+ "project",
28
+ "time-tracking",
29
+ "attachment",
30
+ "text-template",
31
+ "incoming-document",
32
+ ];
33
+ /** Read-only resources: no write scope exists or none is needed. */
34
+ const READ_ONLY_SCOPES = ["pdf-templates.readonly", "login.readonly"];
35
+ export function defaultScopes(writes) {
36
+ const resource = RESOURCE_SCOPES.map((r) => (writes ? r : `${r}.readonly`));
37
+ return [...resource, ...READ_ONLY_SCOPES];
38
+ }
39
+ const SLUG = /^[a-z0-9][a-z0-9_-]{0,39}$/;
40
+ function fail(message) {
41
+ throw new Error(`Hosted mode configuration: ${message}`);
42
+ }
43
+ function parseTenants(raw, source) {
44
+ let parsed;
45
+ try {
46
+ parsed = JSON.parse(raw);
47
+ }
48
+ catch (error) {
49
+ fail(`${source} is not valid JSON (${error instanceof Error ? error.message : String(error)})`);
50
+ }
51
+ const list = Array.isArray(parsed)
52
+ ? parsed
53
+ : parsed?.tenants;
54
+ if (!Array.isArray(list) || list.length === 0) {
55
+ fail(`${source} must contain a non-empty "tenants" array`);
56
+ }
57
+ const seen = new Set();
58
+ return list.map((entry, index) => {
59
+ const t = (entry ?? {});
60
+ const where = `${source} tenants[${index}]`;
61
+ // Case-insensitive: "HMD" becomes "hmd", the value the model passes as `account`.
62
+ const id = typeof t.id === "string" ? t.id.trim().toLowerCase() : "";
63
+ if (!SLUG.test(id))
64
+ fail(`${where}.id must be a slug (letters, digits, - and _), got ${JSON.stringify(t.id)}`);
65
+ if (seen.has(id))
66
+ fail(`${where}.id "${id}" is used twice`);
67
+ seen.add(id);
68
+ const name = typeof t.name === "string" && t.name.trim() ? t.name.trim() : id;
69
+ const writes = t.writes === true;
70
+ let rateLimitPerMinute = 10;
71
+ if (typeof t.rate_limit_per_minute === "number" && t.rate_limit_per_minute >= 1) {
72
+ rateLimitPerMinute = Math.floor(t.rate_limit_per_minute);
73
+ }
74
+ else if (t.plan !== undefined) {
75
+ const plan = String(t.plan).toUpperCase();
76
+ if (PLANS_WITHOUT_API.has(plan)) {
77
+ fail(`${where}: easybill's ${t.plan} plan has no REST API access — Professional or Premium is required`);
78
+ }
79
+ const limit = PLAN_LIMITS[plan];
80
+ if (limit === undefined)
81
+ fail(`${where}.plan must be PROFESSIONAL or PREMIUM, got ${JSON.stringify(t.plan)}`);
82
+ rateLimitPerMinute = limit;
83
+ }
84
+ let scopes = defaultScopes(writes);
85
+ if (t.scopes !== undefined) {
86
+ if (!Array.isArray(t.scopes) || !t.scopes.every((s) => typeof s === "string")) {
87
+ fail(`${where}.scopes must be an array of strings`);
88
+ }
89
+ scopes = t.scopes;
90
+ }
91
+ let match;
92
+ if (t.match !== undefined) {
93
+ if (!t.match || typeof t.match !== "object" || Array.isArray(t.match)) {
94
+ fail(`${where}.match must be an object of claim -> value`);
95
+ }
96
+ match = t.match;
97
+ }
98
+ return { id, name, writes, rateLimitPerMinute, scopes, ...(match ? { match } : {}) };
99
+ });
100
+ }
101
+ function intEnv(env, name, fallback) {
102
+ const raw = env[name];
103
+ if (!raw)
104
+ return fallback;
105
+ const value = Number.parseInt(raw, 10);
106
+ if (Number.isNaN(value) || value < 1)
107
+ fail(`${name} must be a positive integer`);
108
+ return value;
109
+ }
110
+ export function loadHostedConfig(env = process.env) {
111
+ const rawUrl = env.EASYBILL_PUBLIC_URL?.trim();
112
+ if (!rawUrl)
113
+ fail("EASYBILL_PUBLIC_URL is required, e.g. https://easybill-mcp.example.com");
114
+ let publicUrl;
115
+ try {
116
+ publicUrl = new URL(rawUrl.replace(/\/+$/, ""));
117
+ }
118
+ catch {
119
+ fail(`EASYBILL_PUBLIC_URL is not a valid URL: ${rawUrl}`);
120
+ }
121
+ const localhost = ["localhost", "127.0.0.1", "[::1]"].includes(publicUrl.hostname);
122
+ // Same escape hatch the MCP SDK uses for its issuer check — for LAN tests only:
123
+ // API keys and tokens then travel unencrypted.
124
+ const insecureAllowed = /^(1|true)$/.test(env.MCP_DANGEROUSLY_ALLOW_INSECURE_ISSUER_URL ?? "");
125
+ if (publicUrl.protocol !== "https:" && !localhost && !insecureAllowed) {
126
+ fail("EASYBILL_PUBLIC_URL must use https (http is only allowed for localhost; for a test in a " +
127
+ "trusted local network set MCP_DANGEROUSLY_ALLOW_INSECURE_ISSUER_URL=true)");
128
+ }
129
+ const secret = env.EASYBILL_MCP_SECRET ?? "";
130
+ if (secret.length < 32) {
131
+ fail("EASYBILL_MCP_SECRET must be at least 32 characters (e.g. `openssl rand -base64 48`)");
132
+ }
133
+ let tenants;
134
+ if (env.EASYBILL_TENANTS?.trim()) {
135
+ tenants = parseTenants(env.EASYBILL_TENANTS, "EASYBILL_TENANTS");
136
+ }
137
+ else if (env.EASYBILL_TENANTS_FILE?.trim()) {
138
+ const file = env.EASYBILL_TENANTS_FILE.trim();
139
+ let raw;
140
+ try {
141
+ raw = readFileSync(file, "utf8");
142
+ }
143
+ catch (error) {
144
+ fail(`cannot read EASYBILL_TENANTS_FILE ${file} (${error instanceof Error ? error.message : String(error)})`);
145
+ }
146
+ tenants = parseTenants(raw, file);
147
+ }
148
+ else {
149
+ fail("set EASYBILL_TENANTS_FILE (path to a JSON file) or EASYBILL_TENANTS (inline JSON)");
150
+ }
151
+ const clientId = env.EASYBILL_OAUTH_CLIENT_ID?.trim();
152
+ const clientSecret = env.EASYBILL_OAUTH_CLIENT_SECRET?.trim();
153
+ const rawMode = env.EASYBILL_CONNECT_MODE?.trim().toLowerCase();
154
+ if (rawMode && rawMode !== "apikey" && rawMode !== "oauth") {
155
+ fail(`EASYBILL_CONNECT_MODE must be "apikey" or "oauth", got ${JSON.stringify(rawMode)}`);
156
+ }
157
+ const connectMode = rawMode || (clientId ? "oauth" : "apikey");
158
+ const teamDomain = env.EASYBILL_CF_ACCESS_TEAM_DOMAIN?.trim();
159
+ const accessAud = env.EASYBILL_CF_ACCESS_AUD?.trim();
160
+ if (Boolean(teamDomain) !== Boolean(accessAud)) {
161
+ fail("set both EASYBILL_CF_ACCESS_TEAM_DOMAIN and EASYBILL_CF_ACCESS_AUD, or neither");
162
+ }
163
+ let cloudflareAccess;
164
+ if (teamDomain && accessAud) {
165
+ // Accepts "team", "team.cloudflareaccess.com" or a full URL.
166
+ const issuer = teamDomain.includes("://")
167
+ ? teamDomain
168
+ : `https://${teamDomain.includes(".") ? teamDomain : `${teamDomain}.cloudflareaccess.com`}`;
169
+ cloudflareAccess = { issuer: issuer.replace(/\/+$/, ""), audience: accessAud };
170
+ }
171
+ let icon;
172
+ const iconPath = env.EASYBILL_ICON_PATH?.trim();
173
+ if (iconPath) {
174
+ const extension = /\.(svg|png|ico)$/i.exec(iconPath)?.[1]?.toLowerCase();
175
+ if (!extension)
176
+ fail(`EASYBILL_ICON_PATH must end in .svg, .png or .ico, got ${JSON.stringify(iconPath)}`);
177
+ const mimeType = { svg: "image/svg+xml", png: "image/png", ico: "image/x-icon" }[extension];
178
+ icon = { path: iconPath, mimeType, extension };
179
+ }
180
+ return {
181
+ publicUrl,
182
+ mcpUrl: new URL(`${publicUrl.href.replace(/\/+$/, "")}/mcp`),
183
+ host: env.HOST?.trim() || "0.0.0.0",
184
+ port: intEnv(env, "PORT", 3000),
185
+ secret,
186
+ dbPath: env.EASYBILL_DB_PATH?.trim() || "./data/easybill-mcp.sqlite",
187
+ tenants,
188
+ connectMode,
189
+ upstream: {
190
+ issuer: (env.EASYBILL_OAUTH_ISSUER?.trim() || "https://api.easybill.de").replace(/\/+$/, ""),
191
+ ...(clientId ? { clientId } : {}),
192
+ ...(clientSecret ? { clientSecret } : {}),
193
+ },
194
+ ...(cloudflareAccess ? { cloudflareAccess } : {}),
195
+ ...(icon ? { icon } : {}),
196
+ accessTokenTtlSeconds: intEnv(env, "EASYBILL_MCP_ACCESS_TOKEN_TTL", 3600),
197
+ refreshTokenTtlSeconds: intEnv(env, "EASYBILL_MCP_REFRESH_TOKEN_TTL", 90 * 24 * 3600),
198
+ };
199
+ }
200
+ //# sourceMappingURL=config.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/hosted/config.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,23 @@
1
+ /**
2
+ * Hosted mode: Streamable HTTP transport + OAuth, for use as a remote connector
3
+ * (claude.ai "Custom connector", Claude Code `--transport http`, …).
4
+ *
5
+ * Routes:
6
+ * /.well-known/*, /authorize, /token, /register, /revoke OAuth (SDK mcpAuthRouter)
7
+ * /connect/... connect page + easybill OAuth callback
8
+ * POST /mcp MCP endpoint (stateless, bearer auth)
9
+ * GET /healthz liveness
10
+ * GET /favicon.ico, /favicon.<ext> icon (only with EASYBILL_ICON_PATH)
11
+ */
12
+ import express from "express";
13
+ import { type HostedConfig } from "./config.js";
14
+ import { Store } from "./store.js";
15
+ export interface HostedApp {
16
+ app: express.Express;
17
+ store: Store;
18
+ config: HostedConfig;
19
+ }
20
+ /** Builds the app without listening — used by start() and by tests. */
21
+ export declare function createHostedApp(config: HostedConfig): Promise<HostedApp>;
22
+ /** Entry point for `easybill-mcp --http`. */
23
+ export declare function startHttpServer(): Promise<void>;