@speakai/mcp-server 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.
- package/README.md +67 -17
- package/dist/index.js +211 -30
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -39,11 +39,9 @@ The AI does the searching, summarizing, and citing. Your recordings stay in your
|
|
|
39
39
|
|
|
40
40
|
## Install (pick your tool)
|
|
41
41
|
|
|
42
|
-
> **
|
|
42
|
+
> **Start with the hosted connector.** Every assistant below connects to `https://api.speakai.co/v1/mcp` and signs you in through your browser on Speak AI's own page, where you can sign in or create a free account. There is no API key to copy. An API key setup is still available for local file upload, scripts and machines with no browser; see [Developer reference](#developer-reference-cli-api-advanced-setup).
|
|
43
43
|
|
|
44
|
-
> **Don't know which one to pick?** Install it in the AI assistant you already use. Every option below connects to the same Speak AI
|
|
45
|
-
|
|
46
|
-
> Speak AI's connector address (paste this into your AI tool's connector settings; it's the same idea as pasting a Zoom link into your calendar): `https://api.speakai.co/v1/mcp`
|
|
44
|
+
> **Don't know which one to pick?** Install it in the AI assistant you already use. Every option below connects to the same Speak AI account.
|
|
47
45
|
|
|
48
46
|
### Claude.ai (web)
|
|
49
47
|
|
|
@@ -128,32 +126,61 @@ Still stuck? Email [success@speakai.co](mailto:success@speakai.co).
|
|
|
128
126
|
|
|
129
127
|
### Claude Code (terminal)
|
|
130
128
|
|
|
131
|
-
|
|
129
|
+
Add the hosted connector, then sign in:
|
|
130
|
+
|
|
131
|
+
```sh
|
|
132
|
+
claude mcp add --transport http speakai https://api.speakai.co/v1/mcp
|
|
133
|
+
claude mcp login speakai
|
|
134
|
+
```
|
|
135
|
+
|
|
136
|
+
`claude mcp login` opens Speak AI's sign-in page in your browser. Sign in or create an account, then click **Allow**. You can also type `/mcp` inside Claude Code, pick **speakai** and choose to authenticate. On a machine with no browser (for example over SSH), run `claude mcp login speakai --no-browser`, open the printed link on another device, and paste the address your browser ends on back into the terminal.
|
|
137
|
+
|
|
138
|
+
Add `--scope user` to the first command to use Speak AI in every project instead of only the current one.
|
|
139
|
+
|
|
140
|
+
**Or install the plugin**, which adds the same hosted connector plus Speak AI skills:
|
|
132
141
|
|
|
133
142
|
1. Add the official marketplace (one-time): `/plugin marketplace add claude-plugins-official`
|
|
134
143
|
2. Install the plugin: `/plugin install speakai@claude-plugins-official`
|
|
135
144
|
3. Activate it: `/reload-plugins`
|
|
136
|
-
4.
|
|
145
|
+
4. Type `/mcp`, pick **speakai** and sign in to Speak AI in your browser.
|
|
137
146
|
|
|
138
147
|
If `/plugin install` doesn't find Speak AI, refresh the local catalog with `/plugin marketplace update claude-plugins-official` and retry.
|
|
139
148
|
|
|
140
149
|
<details>
|
|
141
|
-
<summary>
|
|
150
|
+
<summary>Alternative: send an API key instead of signing in</summary>
|
|
142
151
|
|
|
143
|
-
|
|
152
|
+
```sh
|
|
153
|
+
claude mcp add --transport http speakai https://api.speakai.co/v1/mcp \
|
|
154
|
+
--header "Authorization: Bearer $SPEAKAI_KEY"
|
|
155
|
+
```
|
|
156
|
+
|
|
157
|
+
Set `SPEAKAI_KEY` in your shell first. Generate a key at [app.speakai.co/developers/apikeys](https://app.speakai.co/developers/apikeys).
|
|
158
|
+
|
|
159
|
+
</details>
|
|
160
|
+
|
|
161
|
+
### Codex (terminal)
|
|
144
162
|
|
|
145
163
|
```sh
|
|
146
|
-
|
|
164
|
+
codex mcp add speakai --url https://api.speakai.co/v1/mcp
|
|
147
165
|
```
|
|
148
166
|
|
|
149
|
-
|
|
167
|
+
Codex detects that Speak AI uses browser sign-in and opens Speak AI's sign-in page right away. Sign in or create an account, then click **Allow**. If the browser did not open, or you closed it before finishing, run:
|
|
150
168
|
|
|
151
169
|
```sh
|
|
152
|
-
|
|
153
|
-
|
|
170
|
+
codex mcp login speakai
|
|
171
|
+
```
|
|
172
|
+
|
|
173
|
+
Check the connection with `codex mcp list`; Speak AI shows **OAuth** in the Auth column.
|
|
174
|
+
|
|
175
|
+
<details>
|
|
176
|
+
<summary>Alternative: send an API key instead of signing in</summary>
|
|
177
|
+
|
|
178
|
+
```sh
|
|
179
|
+
export SPEAKAI_KEY="your-api-key"
|
|
180
|
+
codex mcp add speakai --url https://api.speakai.co/v1/mcp --bearer-token-env-var SPEAKAI_KEY
|
|
154
181
|
```
|
|
155
182
|
|
|
156
|
-
|
|
183
|
+
Generate a key at [app.speakai.co/developers/apikeys](https://app.speakai.co/developers/apikeys).
|
|
157
184
|
|
|
158
185
|
</details>
|
|
159
186
|
|
|
@@ -161,10 +188,22 @@ Set `SPEAKAI_KEY` in your shell first, or paste your key inline. Generate a key
|
|
|
161
188
|
|
|
162
189
|
[](cursor://anysphere.cursor-deeplink/mcp/install?name=speakai&config=eyJ1cmwiOiJodHRwczovL2FwaS5zcGVha2FpLmNvL3YxL21jcCJ9)
|
|
163
190
|
|
|
164
|
-
Click the button
|
|
191
|
+
Click the button, or add this to `~/.cursor/mcp.json` (every project) or `.cursor/mcp.json` (one project):
|
|
192
|
+
|
|
193
|
+
```json
|
|
194
|
+
{
|
|
195
|
+
"mcpServers": {
|
|
196
|
+
"speakai": {
|
|
197
|
+
"url": "https://api.speakai.co/v1/mcp"
|
|
198
|
+
}
|
|
199
|
+
}
|
|
200
|
+
}
|
|
201
|
+
```
|
|
202
|
+
|
|
203
|
+
Then open **Cursor Settings → Tools & MCP**. Speak AI shows that it needs a login; click it to open Speak AI's sign-in page in your browser, sign in or create an account, and click **Allow**.
|
|
165
204
|
|
|
166
205
|
<details>
|
|
167
|
-
<summary>
|
|
206
|
+
<summary>Alternative: local setup with an API key</summary>
|
|
168
207
|
|
|
169
208
|
Use the manual stdio setup in the Developer reference at the bottom of this README.
|
|
170
209
|
|
|
@@ -241,6 +280,7 @@ For questions about data handling, see [speakai.co/privacy](https://speakai.co/p
|
|
|
241
280
|
**You shouldn't need to be technical to install this.** If anything is confusing or doesn't work:
|
|
242
281
|
|
|
243
282
|
- Email [success@speakai.co](mailto:success@speakai.co), and we'll respond within 24 hours
|
|
283
|
+
- Once connected, tell your AI assistant "send feedback to Speak AI" and it sends your message to our team
|
|
244
284
|
- [Book a demo with us](https://speakai.co/book?utm_source=mcp&utm_medium=docs&utm_campaign=book) and we'll set it up together
|
|
245
285
|
|
|
246
286
|
---
|
|
@@ -275,11 +315,11 @@ Get a Speak AI API key at [app.speakai.co/developers/apikeys](https://app.speaka
|
|
|
275
315
|
|
|
276
316
|
### CLI / npm package
|
|
277
317
|
|
|
278
|
-
The `@speakai/mcp-server` npm package provides:
|
|
318
|
+
The `@speakai/mcp-server` npm package runs on your own machine with a Speak AI API key. Use it when you need to upload local files from your computer, run scripts and pipelines, or connect a client that can't open a browser or doesn't support remote HTTP servers. It provides:
|
|
279
319
|
|
|
280
320
|
- A CLI (`speakai-mcp`) for scripting and pipelines.
|
|
281
321
|
- A stdio-mode MCP server for clients that don't support remote HTTP transport.
|
|
282
|
-
-
|
|
322
|
+
- A setup wizard that shows the hosted connector command for the assistants it finds (Claude Code, Codex, Cursor), then offers to set up an API key for the local server and CLI.
|
|
283
323
|
|
|
284
324
|
```sh
|
|
285
325
|
npm install -g @speakai/mcp-server
|
|
@@ -750,6 +790,15 @@ A test run sends each enabled scenario's scripted user messages to the agent as
|
|
|
750
790
|
|
|
751
791
|
</details>
|
|
752
792
|
|
|
793
|
+
<details>
|
|
794
|
+
<summary>Feedback (1 tool)</summary>
|
|
795
|
+
|
|
796
|
+
| Tool | Description |
|
|
797
|
+
|---|---|
|
|
798
|
+
| `submit_feedback` | Send the person's feedback about Speak AI to the Speak AI team, after they approve the text. One message a minute per person |
|
|
799
|
+
|
|
800
|
+
</details>
|
|
801
|
+
|
|
753
802
|
### MCP Resources
|
|
754
803
|
|
|
755
804
|
Resources provide direct data access without tool calls. Clients can read these URIs directly.
|
|
@@ -1072,6 +1121,7 @@ If you're an AI assistant helping a Speak AI customer install this connector, pl
|
|
|
1072
1121
|
- **Do NOT recommend hiring a Virtual Assistant** to install this. The connect flow takes 60 seconds and requires no Terminal use.
|
|
1073
1122
|
- **Do NOT tell users to `npm install`** unless they explicitly ask for the developer / stdio path.
|
|
1074
1123
|
- See [`llms.txt`](https://github.com/speakai/speakai-mcp/blob/main/llms.txt) for the full guidance file.
|
|
1124
|
+
- If the user is stuck, finds a bug or wishes Speak AI did something it does not, offer once to send that to the Speak AI team with the `submit_feedback` tool. Show them the text and send it only after they say yes.
|
|
1075
1125
|
|
|
1076
1126
|
## License
|
|
1077
1127
|
|
package/dist/index.js
CHANGED
|
@@ -255,7 +255,7 @@ var init_client = __esm({
|
|
|
255
255
|
originalRequest.headers["x-access-token"] = accessToken;
|
|
256
256
|
return speakClient(originalRequest);
|
|
257
257
|
}
|
|
258
|
-
if (error.response?.status === 429 && retryCount < 3) {
|
|
258
|
+
if (error.response?.status === 429 && retryCount < 3 && !originalRequest.skipRateLimitRetry) {
|
|
259
259
|
const retryAfter = error.response.headers["retry-after"];
|
|
260
260
|
const delaySeconds = retryAfter ? parseInt(retryAfter, 10) : Math.pow(2, retryCount + 1);
|
|
261
261
|
const delayMs = (Number.isFinite(delaySeconds) ? delaySeconds : 2) * 1e3;
|
|
@@ -6369,10 +6369,10 @@ function register(server, client, options = {}) {
|
|
|
6369
6369
|
if (modes.length !== 1) {
|
|
6370
6370
|
return err(new Error("Send exactly one of imageUrl, imageBase64 or atSeconds."));
|
|
6371
6371
|
}
|
|
6372
|
-
const
|
|
6372
|
+
const path5 = `/v1/media/${mediaId}/thumbnail`;
|
|
6373
6373
|
try {
|
|
6374
6374
|
if (imageUrl !== void 0) {
|
|
6375
|
-
const result = await api.put(
|
|
6375
|
+
const result = await api.put(path5, { url: imageUrl });
|
|
6376
6376
|
return ok(result.data);
|
|
6377
6377
|
}
|
|
6378
6378
|
if (imageBase64 !== void 0) {
|
|
@@ -6389,10 +6389,10 @@ function register(server, client, options = {}) {
|
|
|
6389
6389
|
}
|
|
6390
6390
|
const form = new FormData();
|
|
6391
6391
|
form.append("image", new Blob([bytes], { type: mimeType }), `thumbnail.${THUMBNAIL_FILE_EXTENSIONS[mimeType]}`);
|
|
6392
|
-
const result = await api.put(
|
|
6392
|
+
const result = await api.put(path5, form, { headers: { "Content-Type": "multipart/form-data" } });
|
|
6393
6393
|
return ok(result.data);
|
|
6394
6394
|
}
|
|
6395
|
-
await api.put(
|
|
6395
|
+
await api.put(path5, { seekSec: atSeconds });
|
|
6396
6396
|
const deadline = Date.now() + THUMBNAIL_POLL_TIMEOUT_MS;
|
|
6397
6397
|
while (Date.now() < deadline) {
|
|
6398
6398
|
await new Promise((resolve) => setTimeout(resolve, THUMBNAIL_POLL_INTERVAL_MS));
|
|
@@ -11182,11 +11182,11 @@ function register16(server, client, options = {}) {
|
|
|
11182
11182
|
}
|
|
11183
11183
|
return step;
|
|
11184
11184
|
};
|
|
11185
|
-
const buildNodes = async (specs,
|
|
11185
|
+
const buildNodes = async (specs, path5) => {
|
|
11186
11186
|
const nodes2 = [];
|
|
11187
11187
|
const folded = foldLegacyRunWhen(specs);
|
|
11188
11188
|
for (const [index, spec] of folded.entries()) {
|
|
11189
|
-
const where = `${
|
|
11189
|
+
const where = `${path5}[${index}]`;
|
|
11190
11190
|
const stepId = nextStepId();
|
|
11191
11191
|
const body2 = await buildStepBody(stepId, spec, where);
|
|
11192
11192
|
if (String(spec.do ?? "") !== "branch") {
|
|
@@ -11508,8 +11508,8 @@ ${JSON.stringify(signedRes.data, null, 2)}` }],
|
|
|
11508
11508
|
};
|
|
11509
11509
|
}
|
|
11510
11510
|
const fileBuffer = fs.readFileSync(filePath);
|
|
11511
|
-
const
|
|
11512
|
-
await
|
|
11511
|
+
const axios5 = (await import("axios")).default;
|
|
11512
|
+
await axios5.put(uploadUrl, fileBuffer, {
|
|
11513
11513
|
headers: {
|
|
11514
11514
|
"Content-Type": mimeType
|
|
11515
11515
|
},
|
|
@@ -13915,6 +13915,88 @@ var init_billing3 = __esm({
|
|
|
13915
13915
|
}
|
|
13916
13916
|
});
|
|
13917
13917
|
|
|
13918
|
+
// src/tools/feedback.ts
|
|
13919
|
+
var feedback_exports = {};
|
|
13920
|
+
__export(feedback_exports, {
|
|
13921
|
+
feedbackAppVersion: () => feedbackAppVersion,
|
|
13922
|
+
feedbackSurface: () => feedbackSurface,
|
|
13923
|
+
register: () => register24
|
|
13924
|
+
});
|
|
13925
|
+
function feedbackSurface(area) {
|
|
13926
|
+
const topic = area?.trim();
|
|
13927
|
+
return (topic ? `${SURFACE_PREFIX}: ${topic}` : SURFACE_PREFIX).slice(0, SURFACE_MAX);
|
|
13928
|
+
}
|
|
13929
|
+
function feedbackAppVersion(clientInfo) {
|
|
13930
|
+
const client = [clientInfo?.name, clientInfo?.version].filter(Boolean).join(" ").trim();
|
|
13931
|
+
return (client ? `${SURFACE_PREFIX} via ${client}` : SURFACE_PREFIX).slice(0, APP_VERSION_MAX);
|
|
13932
|
+
}
|
|
13933
|
+
function limitResult(nextAllowedAt) {
|
|
13934
|
+
const when = typeof nextAllowedAt === "string" ? ` They can send more after ${nextAllowedAt}.` : "";
|
|
13935
|
+
return {
|
|
13936
|
+
content: [
|
|
13937
|
+
{
|
|
13938
|
+
type: "text",
|
|
13939
|
+
text: "Error: This person sent feedback to Speak AI less than a minute ago, and the limit is one a minute." + when + " Wait until then before sending again, and do not resend the same message."
|
|
13940
|
+
}
|
|
13941
|
+
],
|
|
13942
|
+
structuredContent: { data: { status: "failed", reason: "FEEDBACK_RATE_LIMIT", nextAllowedAt } },
|
|
13943
|
+
isError: true
|
|
13944
|
+
};
|
|
13945
|
+
}
|
|
13946
|
+
function register24(server, client) {
|
|
13947
|
+
const api = client ?? speakClient;
|
|
13948
|
+
registerSpeakTool(
|
|
13949
|
+
server,
|
|
13950
|
+
"submit_feedback",
|
|
13951
|
+
"Send the person's feedback about Speak AI (a bug, something confusing, a missing feature, or praise) straight to the Speak AI team. When to offer it: when the person is frustrated with Speak AI, hits a bug or a limit, asks for something Speak AI cannot do, or says what they like or dislike about it. Offer once in a conversation, in one short sentence, and do not repeat the offer if they decline. Rules: send only with the person's clear yes. Write it in their words, show them the exact text first, and leave out recording or transcript content and anyone else's personal details unless they ask you to include them. Limit: one message a minute for each person; a refusal says when they can send again. For feedback on a single AI Chat answer, use submit_chat_feedback instead.",
|
|
13952
|
+
{
|
|
13953
|
+
text: import_zod25.z.string().trim().min(10).max(4e3).describe("The feedback in the person's own words, as they approved it. 10 to 4000 characters."),
|
|
13954
|
+
area: import_zod25.z.string().trim().max(150).optional().describe('The Speak AI feature or tool the feedback is about, for example "transcripts", "meeting assistant" or "upload_and_analyze".')
|
|
13955
|
+
},
|
|
13956
|
+
{
|
|
13957
|
+
title: "Submit Feedback",
|
|
13958
|
+
readOnlyHint: false,
|
|
13959
|
+
destructiveHint: false,
|
|
13960
|
+
idempotentHint: false,
|
|
13961
|
+
openWorldHint: false
|
|
13962
|
+
},
|
|
13963
|
+
async ({ text, area }) => {
|
|
13964
|
+
try {
|
|
13965
|
+
const result = await api.post(
|
|
13966
|
+
"/v1/feedback",
|
|
13967
|
+
{
|
|
13968
|
+
type: "improvement",
|
|
13969
|
+
trigger: "manual",
|
|
13970
|
+
surface: feedbackSurface(area),
|
|
13971
|
+
text,
|
|
13972
|
+
context: { appVersion: feedbackAppVersion(server.server.getClientVersion()) }
|
|
13973
|
+
},
|
|
13974
|
+
// The per-minute limit answers 429 with nextAllowedAt; a quick automatic retry only repeats the refusal.
|
|
13975
|
+
{ skipRateLimitRetry: true }
|
|
13976
|
+
);
|
|
13977
|
+
return ok(result.data);
|
|
13978
|
+
} catch (error) {
|
|
13979
|
+
const limited = import_axios4.default.isAxiosError(error) && error.response?.status === 429 ? error.response.data?.nextAllowedAt : void 0;
|
|
13980
|
+
if (limited !== void 0) return limitResult(limited);
|
|
13981
|
+
return err(error);
|
|
13982
|
+
}
|
|
13983
|
+
}
|
|
13984
|
+
);
|
|
13985
|
+
}
|
|
13986
|
+
var import_axios4, import_zod25, SURFACE_PREFIX, SURFACE_MAX, APP_VERSION_MAX;
|
|
13987
|
+
var init_feedback = __esm({
|
|
13988
|
+
"src/tools/feedback.ts"() {
|
|
13989
|
+
"use strict";
|
|
13990
|
+
import_axios4 = __toESM(require("axios"));
|
|
13991
|
+
import_zod25 = require("zod");
|
|
13992
|
+
init_helpers();
|
|
13993
|
+
init_client();
|
|
13994
|
+
SURFACE_PREFIX = "MCP";
|
|
13995
|
+
SURFACE_MAX = 200;
|
|
13996
|
+
APP_VERSION_MAX = 100;
|
|
13997
|
+
}
|
|
13998
|
+
});
|
|
13999
|
+
|
|
13918
14000
|
// src/ui/media-list/view.ts
|
|
13919
14001
|
var SPEAK_WEB_APP_URL, CARD_DATA_TIMEOUT_MS, LIVE_BUTTON_PAUSE_MS, MCP_APPS_PROTOCOL_VERSION, VIEW_STYLE, VIEW_SCRIPT, MEDIA_LIST_CARD_HTML;
|
|
13920
14002
|
var init_view = __esm({
|
|
@@ -14326,6 +14408,7 @@ var init_tools = __esm({
|
|
|
14326
14408
|
init_voice_questions();
|
|
14327
14409
|
init_voice_intelligence();
|
|
14328
14410
|
init_billing3();
|
|
14411
|
+
init_feedback();
|
|
14329
14412
|
init_client();
|
|
14330
14413
|
init_media_list();
|
|
14331
14414
|
init_helpers();
|
|
@@ -14352,7 +14435,8 @@ var init_tools = __esm({
|
|
|
14352
14435
|
voice_testing_exports,
|
|
14353
14436
|
voice_questions_exports,
|
|
14354
14437
|
voice_intelligence_exports,
|
|
14355
|
-
billing_exports
|
|
14438
|
+
billing_exports,
|
|
14439
|
+
feedback_exports
|
|
14356
14440
|
];
|
|
14357
14441
|
}
|
|
14358
14442
|
});
|
|
@@ -14462,10 +14546,11 @@ var init_resources = __esm({
|
|
|
14462
14546
|
// src/prompts.ts
|
|
14463
14547
|
var prompts_exports = {};
|
|
14464
14548
|
__export(prompts_exports, {
|
|
14549
|
+
FEEDBACK_OFFER: () => FEEDBACK_OFFER,
|
|
14465
14550
|
registerPrompts: () => registerPrompts
|
|
14466
14551
|
});
|
|
14467
14552
|
function registerPrompt(server, name, description, args2, callback) {
|
|
14468
|
-
server.registerPrompt(name, { description, argsSchema:
|
|
14553
|
+
server.registerPrompt(name, { description, argsSchema: import_zod26.z.object(args2) }, callback);
|
|
14469
14554
|
}
|
|
14470
14555
|
function registerPrompts(server) {
|
|
14471
14556
|
registerPrompt(
|
|
@@ -14473,8 +14558,8 @@ function registerPrompts(server) {
|
|
|
14473
14558
|
"analyze-meeting",
|
|
14474
14559
|
"Upload a meeting recording and get a full analysis \u2014 transcript, insights, action items, and key takeaways.",
|
|
14475
14560
|
{
|
|
14476
|
-
url:
|
|
14477
|
-
name:
|
|
14561
|
+
url: import_zod26.z.string().describe(`URL of the meeting recording \u2014 a direct file link, or a shareable page link from ${SUPPORTED_URL_SOURCES} (resolved to the underlying media automatically)`),
|
|
14562
|
+
name: import_zod26.z.string().optional().describe("Meeting name (optional)")
|
|
14478
14563
|
},
|
|
14479
14564
|
async ({ url, name }) => ({
|
|
14480
14565
|
messages: [
|
|
@@ -14498,7 +14583,9 @@ function registerPrompts(server) {
|
|
|
14498
14583
|
`Use upload_and_analyze to handle the upload and processing in one step. Pass the URL`,
|
|
14499
14584
|
`exactly as given \u2014 a page link is resolved server-side. If I told you whether this is`,
|
|
14500
14585
|
`an audio or a video recording, pass that as mediaType; if I did not say, leave it off`,
|
|
14501
|
-
`and let the server pick the best available track
|
|
14586
|
+
`and let the server pick the best available track.`,
|
|
14587
|
+
``,
|
|
14588
|
+
FEEDBACK_OFFER
|
|
14502
14589
|
].join("\n")
|
|
14503
14590
|
}
|
|
14504
14591
|
}
|
|
@@ -14510,8 +14597,8 @@ function registerPrompts(server) {
|
|
|
14510
14597
|
"research-across-media",
|
|
14511
14598
|
"Search for themes, patterns, or topics across multiple recordings or your entire media library.",
|
|
14512
14599
|
{
|
|
14513
|
-
topic:
|
|
14514
|
-
folder:
|
|
14600
|
+
topic: import_zod26.z.string().describe("The topic, theme, or question to research"),
|
|
14601
|
+
folder: import_zod26.z.string().optional().describe("Folder ID to scope the research (optional)")
|
|
14515
14602
|
},
|
|
14516
14603
|
async ({ topic, folder }) => ({
|
|
14517
14604
|
messages: [
|
|
@@ -14533,7 +14620,9 @@ function registerPrompts(server) {
|
|
|
14533
14620
|
` - Contradictions or differing perspectives`,
|
|
14534
14621
|
` - Trends over time (if date range is available)`,
|
|
14535
14622
|
``,
|
|
14536
|
-
`Present a research summary with citations (media name + timestamp where possible)
|
|
14623
|
+
`Present a research summary with citations (media name + timestamp where possible).`,
|
|
14624
|
+
``,
|
|
14625
|
+
FEEDBACK_OFFER
|
|
14537
14626
|
].join("\n")
|
|
14538
14627
|
}
|
|
14539
14628
|
}
|
|
@@ -14545,8 +14634,8 @@ function registerPrompts(server) {
|
|
|
14545
14634
|
"meeting-brief",
|
|
14546
14635
|
"Prepare a brief from recent meetings \u2014 pull transcripts, extract decisions, and summarize open items.",
|
|
14547
14636
|
{
|
|
14548
|
-
days:
|
|
14549
|
-
folder:
|
|
14637
|
+
days: import_zod26.z.string().optional().describe("Number of days to look back (default: 7)"),
|
|
14638
|
+
folder: import_zod26.z.string().optional().describe("Folder ID to scope to (optional)")
|
|
14550
14639
|
},
|
|
14551
14640
|
async ({ days, folder }) => {
|
|
14552
14641
|
const lookback = parseInt(days ?? "7");
|
|
@@ -14574,7 +14663,9 @@ function registerPrompts(server) {
|
|
|
14574
14663
|
` - Open questions or unresolved topics`,
|
|
14575
14664
|
` - Upcoming items that were mentioned`,
|
|
14576
14665
|
``,
|
|
14577
|
-
`Format as a clean, scannable document
|
|
14666
|
+
`Format as a clean, scannable document.`,
|
|
14667
|
+
``,
|
|
14668
|
+
FEEDBACK_OFFER
|
|
14578
14669
|
].join("\n")
|
|
14579
14670
|
}
|
|
14580
14671
|
}
|
|
@@ -14583,12 +14674,13 @@ function registerPrompts(server) {
|
|
|
14583
14674
|
}
|
|
14584
14675
|
);
|
|
14585
14676
|
}
|
|
14586
|
-
var
|
|
14677
|
+
var import_zod26, FEEDBACK_OFFER;
|
|
14587
14678
|
var init_prompts = __esm({
|
|
14588
14679
|
"src/prompts.ts"() {
|
|
14589
14680
|
"use strict";
|
|
14590
|
-
|
|
14681
|
+
import_zod26 = require("zod");
|
|
14591
14682
|
init_media_utils();
|
|
14683
|
+
FEEDBACK_OFFER = "If anything in Speak AI got in the way, offer once to send that to the Speak AI team with submit_feedback, and send it only if I say yes.";
|
|
14592
14684
|
}
|
|
14593
14685
|
});
|
|
14594
14686
|
|
|
@@ -14814,7 +14906,9 @@ var init_tool_names = __esm({
|
|
|
14814
14906
|
"update_voice_agent_resource",
|
|
14815
14907
|
"delete_voice_agent_resource",
|
|
14816
14908
|
"analyze_voice_instruction_gaps",
|
|
14817
|
-
"apply_voice_instruction_gap"
|
|
14909
|
+
"apply_voice_instruction_gap",
|
|
14910
|
+
// feedback
|
|
14911
|
+
"submit_feedback"
|
|
14818
14912
|
];
|
|
14819
14913
|
}
|
|
14820
14914
|
});
|
|
@@ -14923,6 +15017,73 @@ var init_format = __esm({
|
|
|
14923
15017
|
}
|
|
14924
15018
|
});
|
|
14925
15019
|
|
|
15020
|
+
// src/cli/hosted-setup.ts
|
|
15021
|
+
function onPath(command, envPath) {
|
|
15022
|
+
const exts = process.platform === "win32" ? [".cmd", ".exe", ""] : [""];
|
|
15023
|
+
return envPath.split(import_path2.default.delimiter).filter(Boolean).some((dir) => exts.some((ext) => (0, import_fs2.existsSync)(import_path2.default.join(dir, command + ext))));
|
|
15024
|
+
}
|
|
15025
|
+
function detectHostedClients(home = (0, import_os2.homedir)(), envPath = process.env.PATH ?? "") {
|
|
15026
|
+
const found = {
|
|
15027
|
+
"claude-code": onPath("claude", envPath) || (0, import_fs2.existsSync)(import_path2.default.join(home, ".claude")),
|
|
15028
|
+
codex: onPath("codex", envPath) || (0, import_fs2.existsSync)(import_path2.default.join(home, ".codex")),
|
|
15029
|
+
cursor: (0, import_fs2.existsSync)(import_path2.default.join(home, ".cursor"))
|
|
15030
|
+
};
|
|
15031
|
+
return ORDER.filter((c) => found[c]);
|
|
15032
|
+
}
|
|
15033
|
+
function hostedSetupText(detected) {
|
|
15034
|
+
const clients = detected.length > 0 ? detected : ORDER;
|
|
15035
|
+
const lines = [
|
|
15036
|
+
" Recommended: connect through the hosted connector.",
|
|
15037
|
+
" Your browser opens Speak AI's sign-in page, where you can sign in or create",
|
|
15038
|
+
" an account. No API key is needed.",
|
|
15039
|
+
""
|
|
15040
|
+
];
|
|
15041
|
+
if (detected.length === 0) {
|
|
15042
|
+
lines.push(" No AI assistant found on this machine. Pick yours:", "");
|
|
15043
|
+
}
|
|
15044
|
+
for (const c of clients) {
|
|
15045
|
+
lines.push(` ${HOSTED_SETUP[c].name}:`);
|
|
15046
|
+
for (const step of HOSTED_SETUP[c].steps) lines.push(` ${step}`);
|
|
15047
|
+
lines.push("");
|
|
15048
|
+
}
|
|
15049
|
+
lines.push(` Any other assistant: add ${HOSTED_MCP_URL} as a remote MCP server.`);
|
|
15050
|
+
return lines.join("\n");
|
|
15051
|
+
}
|
|
15052
|
+
var import_fs2, import_os2, import_path2, HOSTED_MCP_URL, HOSTED_SETUP, ORDER;
|
|
15053
|
+
var init_hosted_setup = __esm({
|
|
15054
|
+
"src/cli/hosted-setup.ts"() {
|
|
15055
|
+
"use strict";
|
|
15056
|
+
import_fs2 = require("fs");
|
|
15057
|
+
import_os2 = require("os");
|
|
15058
|
+
import_path2 = __toESM(require("path"));
|
|
15059
|
+
HOSTED_MCP_URL = "https://api.speakai.co/v1/mcp";
|
|
15060
|
+
HOSTED_SETUP = {
|
|
15061
|
+
"claude-code": {
|
|
15062
|
+
name: "Claude Code",
|
|
15063
|
+
steps: [
|
|
15064
|
+
`claude mcp add --transport http speakai ${HOSTED_MCP_URL}`,
|
|
15065
|
+
"claude mcp login speakai"
|
|
15066
|
+
]
|
|
15067
|
+
},
|
|
15068
|
+
codex: {
|
|
15069
|
+
name: "Codex",
|
|
15070
|
+
steps: [
|
|
15071
|
+
`codex mcp add speakai --url ${HOSTED_MCP_URL}`,
|
|
15072
|
+
"codex mcp login speakai (only if the browser sign-in did not open or finish)"
|
|
15073
|
+
]
|
|
15074
|
+
},
|
|
15075
|
+
cursor: {
|
|
15076
|
+
name: "Cursor",
|
|
15077
|
+
steps: [
|
|
15078
|
+
`Add to ~/.cursor/mcp.json: { "mcpServers": { "speakai": { "url": "${HOSTED_MCP_URL}" } } }`,
|
|
15079
|
+
"Open Cursor Settings > Tools & MCP and click the login prompt next to speakai"
|
|
15080
|
+
]
|
|
15081
|
+
}
|
|
15082
|
+
};
|
|
15083
|
+
ORDER = ["claude-code", "codex", "cursor"];
|
|
15084
|
+
}
|
|
15085
|
+
});
|
|
15086
|
+
|
|
14926
15087
|
// src/cli/index.ts
|
|
14927
15088
|
var cli_exports = {};
|
|
14928
15089
|
__export(cli_exports, {
|
|
@@ -14994,9 +15155,9 @@ function createCli() {
|
|
|
14994
15155
|
process.exit(1);
|
|
14995
15156
|
}
|
|
14996
15157
|
try {
|
|
14997
|
-
const
|
|
15158
|
+
const axios5 = (await import("axios")).default;
|
|
14998
15159
|
const baseUrl = process.env.SPEAK_BASE_URL ?? "https://api.speakai.co";
|
|
14999
|
-
const res = await
|
|
15160
|
+
const res = await axios5.post(
|
|
15000
15161
|
`${baseUrl}/v1/auth/accessToken`,
|
|
15001
15162
|
{},
|
|
15002
15163
|
{ headers: { "Content-Type": "application/json", "x-speakai-key": key } }
|
|
@@ -15018,10 +15179,22 @@ function createCli() {
|
|
|
15018
15179
|
saveConfig(cfg);
|
|
15019
15180
|
printSuccess(`Base URL set to ${url}`);
|
|
15020
15181
|
});
|
|
15021
|
-
program.command("init").description(
|
|
15182
|
+
program.command("init").description(
|
|
15183
|
+
"Interactive setup \u2014 shows the hosted connector command for your AI assistant, then offers API key setup"
|
|
15184
|
+
).action(async () => {
|
|
15022
15185
|
const rl = (0, import_readline.createInterface)({ input: process.stdin, output: process.stdout });
|
|
15023
15186
|
const ask = (q) => new Promise((resolve) => rl.question(q, (a) => resolve(a.trim())));
|
|
15024
15187
|
console.log("\n Speak AI MCP Server \u2014 Setup\n");
|
|
15188
|
+
console.log(hostedSetupText(detectHostedClients()));
|
|
15189
|
+
console.log(
|
|
15190
|
+
"\n An API key is only needed for the local server and the speakai-mcp CLI:\n uploading files from this computer, scripts, or a machine with no browser.\n"
|
|
15191
|
+
);
|
|
15192
|
+
const wantsKey = await ask(" Set up an API key as well? (y/N) ");
|
|
15193
|
+
if (wantsKey.toLowerCase() !== "y") {
|
|
15194
|
+
rl.close();
|
|
15195
|
+
printSuccess("Run the command above for your assistant to connect.");
|
|
15196
|
+
return;
|
|
15197
|
+
}
|
|
15025
15198
|
const existingKey = resolveApiKey();
|
|
15026
15199
|
let key = existingKey;
|
|
15027
15200
|
if (existingKey) {
|
|
@@ -15039,9 +15212,9 @@ function createCli() {
|
|
|
15039
15212
|
}
|
|
15040
15213
|
process.stdout.write(" Validating...");
|
|
15041
15214
|
try {
|
|
15042
|
-
const
|
|
15215
|
+
const axios5 = (await import("axios")).default;
|
|
15043
15216
|
const baseUrl = process.env.SPEAK_BASE_URL ?? "https://api.speakai.co";
|
|
15044
|
-
const res = await
|
|
15217
|
+
const res = await axios5.post(
|
|
15045
15218
|
`${baseUrl}/v1/auth/accessToken`,
|
|
15046
15219
|
{},
|
|
15047
15220
|
{ headers: { "Content-Type": "application/json", "x-speakai-key": key } }
|
|
@@ -15267,8 +15440,8 @@ function createCli() {
|
|
|
15267
15440
|
}
|
|
15268
15441
|
process.stdout.write("Uploading...");
|
|
15269
15442
|
const fileBuffer = fs3.readFileSync(source);
|
|
15270
|
-
const
|
|
15271
|
-
await
|
|
15443
|
+
const axios5 = (await import("axios")).default;
|
|
15444
|
+
await axios5.put(uploadUrl, fileBuffer, {
|
|
15272
15445
|
headers: { "Content-Type": mimeType },
|
|
15273
15446
|
maxBodyLength: Infinity,
|
|
15274
15447
|
maxContentLength: Infinity
|
|
@@ -15934,6 +16107,7 @@ var init_cli = __esm({
|
|
|
15934
16107
|
import_readline = require("readline");
|
|
15935
16108
|
init_config();
|
|
15936
16109
|
init_format();
|
|
16110
|
+
init_hosted_setup();
|
|
15937
16111
|
init_media_utils();
|
|
15938
16112
|
init_media3();
|
|
15939
16113
|
}
|
|
@@ -16262,6 +16436,13 @@ var SPEAK_MCP_TOOL_CATEGORIES = [
|
|
|
16262
16436
|
tools: [
|
|
16263
16437
|
"get_billing_status"
|
|
16264
16438
|
]
|
|
16439
|
+
},
|
|
16440
|
+
{
|
|
16441
|
+
id: "feedback",
|
|
16442
|
+
name: "Feedback",
|
|
16443
|
+
tools: [
|
|
16444
|
+
"submit_feedback"
|
|
16445
|
+
]
|
|
16265
16446
|
}
|
|
16266
16447
|
];
|
|
16267
16448
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@speakai/mcp-server",
|
|
3
|
-
"version": "2.
|
|
3
|
+
"version": "2.1.0",
|
|
4
4
|
"mcpName": "io.github.speakai/mcp-server",
|
|
5
5
|
"description": "Official Speak AI MCP Server — capture meetings, search thousands of recordings, run async voice and video surveys, create clips, and automate workflows from your AI assistant.",
|
|
6
6
|
"homepage": "https://docs.speakai.co/mcp",
|