@ounie/mcp 0.2.0 → 0.3.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 +10 -5
- package/dist/api.d.ts +12 -0
- package/dist/api.js +7 -0
- package/dist/api.js.map +1 -1
- package/dist/index.d.ts +6 -4
- package/dist/index.js +59 -13
- package/dist/index.js.map +1 -1
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -64,15 +64,20 @@ claude mcp add ounie --env OUNIE_API_KEY=ounie_live_… -- npx -y @ounie/mcp
|
|
|
64
64
|
|
|
65
65
|
## Remote (HTTP) clients
|
|
66
66
|
|
|
67
|
-
Web clients
|
|
68
|
-
instead of running this package:
|
|
67
|
+
Web clients connect to the hosted endpoint instead of running this package:
|
|
69
68
|
|
|
70
69
|
```
|
|
71
|
-
URL:
|
|
72
|
-
Header: Authorization: Bearer ounie_live_…
|
|
70
|
+
URL: https://ounie.com/api/mcp
|
|
73
71
|
```
|
|
74
72
|
|
|
75
|
-
|
|
73
|
+
- **Claude.ai / ChatGPT custom connectors** sign in with **OAuth** — paste the URL, click
|
|
74
|
+
Connect, and approve on Ounie. No API key needed; the server is a full OAuth 2.1
|
|
75
|
+
authorization server (dynamic client registration + PKCE). Manage/revoke connections at
|
|
76
|
+
**Settings → API keys → Connected apps**.
|
|
77
|
+
- **Header-capable clients** (e.g. Cursor remote) can instead send
|
|
78
|
+
`Authorization: Bearer ounie_live_…` with a personal API key.
|
|
79
|
+
|
|
80
|
+
See https://ounie.com/docs/mcp for per-client steps.
|
|
76
81
|
|
|
77
82
|
## Local development
|
|
78
83
|
|
package/dist/api.d.ts
CHANGED
|
@@ -55,6 +55,18 @@ export declare class OunieClient {
|
|
|
55
55
|
listBrains(): Promise<Brain[]>;
|
|
56
56
|
/** POST /api/brains/:id/ask -> AskAnswer. */
|
|
57
57
|
ask(brainId: string, question: string): Promise<AskAnswer>;
|
|
58
|
+
/**
|
|
59
|
+
* POST /api/brains/:id/context -> raw retrieved wiki pages, NO answer LLM.
|
|
60
|
+
* The caller's own model reasons over `contextText` and cites by `slug`.
|
|
61
|
+
*/
|
|
62
|
+
getContext(brainId: string, query: string): Promise<{
|
|
63
|
+
contextText: string;
|
|
64
|
+
pages: {
|
|
65
|
+
slug: string;
|
|
66
|
+
title: string;
|
|
67
|
+
}[];
|
|
68
|
+
thin: boolean;
|
|
69
|
+
}>;
|
|
58
70
|
/** POST /api/brains/:id/sources { type:"note", title, body } -> { source }. */
|
|
59
71
|
addNote(brainId: string, title: string, body: string): Promise<Source>;
|
|
60
72
|
/** POST /api/brains/:id/sources { type:"link", url } -> { source }. */
|
package/dist/api.js
CHANGED
|
@@ -52,6 +52,13 @@ export class OunieClient {
|
|
|
52
52
|
async ask(brainId, question) {
|
|
53
53
|
return this.request(`/api/brains/${encodeURIComponent(brainId)}/ask`, { method: "POST", body: { question } });
|
|
54
54
|
}
|
|
55
|
+
/**
|
|
56
|
+
* POST /api/brains/:id/context -> raw retrieved wiki pages, NO answer LLM.
|
|
57
|
+
* The caller's own model reasons over `contextText` and cites by `slug`.
|
|
58
|
+
*/
|
|
59
|
+
async getContext(brainId, query) {
|
|
60
|
+
return this.request(`/api/brains/${encodeURIComponent(brainId)}/context`, { method: "POST", body: { query } });
|
|
61
|
+
}
|
|
55
62
|
/** POST /api/brains/:id/sources { type:"note", title, body } -> { source }. */
|
|
56
63
|
async addNote(brainId, title, body) {
|
|
57
64
|
const data = await this.request(`/api/brains/${encodeURIComponent(brainId)}/sources`, { method: "POST", body: { type: "note", title, body } });
|
package/dist/api.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"api.js","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"api.js","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"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"}
|
package/dist/index.d.ts
CHANGED
|
@@ -8,9 +8,11 @@
|
|
|
8
8
|
*
|
|
9
9
|
* Tools:
|
|
10
10
|
* - ounie_list_brains
|
|
11
|
-
* - ounie_ask_brain
|
|
12
|
-
* - ounie_add_note
|
|
13
|
-
* - ounie_add_link
|
|
14
|
-
* -
|
|
11
|
+
* - ounie_ask_brain (brainId, question)
|
|
12
|
+
* - ounie_add_note (brainId, title, body)
|
|
13
|
+
* - ounie_add_link (brainId, url)
|
|
14
|
+
* - ounie_add_to_brain (brainId, content, ...)
|
|
15
|
+
* - ounie_search (brainId, query)
|
|
16
|
+
* - ounie_get_context (brainId, query) raw pages, no answer LLM
|
|
15
17
|
*/
|
|
16
18
|
export {};
|
package/dist/index.js
CHANGED
|
@@ -8,10 +8,12 @@
|
|
|
8
8
|
*
|
|
9
9
|
* Tools:
|
|
10
10
|
* - ounie_list_brains
|
|
11
|
-
* - ounie_ask_brain
|
|
12
|
-
* - ounie_add_note
|
|
13
|
-
* - ounie_add_link
|
|
14
|
-
* -
|
|
11
|
+
* - ounie_ask_brain (brainId, question)
|
|
12
|
+
* - ounie_add_note (brainId, title, body)
|
|
13
|
+
* - ounie_add_link (brainId, url)
|
|
14
|
+
* - ounie_add_to_brain (brainId, content, ...)
|
|
15
|
+
* - ounie_search (brainId, query)
|
|
16
|
+
* - ounie_get_context (brainId, query) raw pages, no answer LLM
|
|
15
17
|
*/
|
|
16
18
|
import { Server } from "@modelcontextprotocol/sdk/server/index.js";
|
|
17
19
|
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
|
|
@@ -30,7 +32,9 @@ const client = new OunieClient({ apiKey: API_KEY, baseUrl: BASE_URL });
|
|
|
30
32
|
const TOOLS = [
|
|
31
33
|
{
|
|
32
34
|
name: "ounie_list_brains",
|
|
33
|
-
description: "List the user's Ounie brains (knowledge containers).
|
|
35
|
+
description: "List the user's Ounie brains (their knowledge containers). Call this FIRST " +
|
|
36
|
+
"to get a brainId — every other Ounie tool requires one. Returns id, name, " +
|
|
37
|
+
"emoji, and source count.",
|
|
34
38
|
inputSchema: {
|
|
35
39
|
type: "object",
|
|
36
40
|
properties: {},
|
|
@@ -39,7 +43,10 @@ const TOOLS = [
|
|
|
39
43
|
},
|
|
40
44
|
{
|
|
41
45
|
name: "ounie_ask_brain",
|
|
42
|
-
description: "
|
|
46
|
+
description: "Answer a question using ONLY the sources saved in one Ounie brain, with " +
|
|
47
|
+
"citations. Prefer this over answering from your own knowledge whenever the " +
|
|
48
|
+
"user asks about their saved material, notes, documents, or 'my brain'. " +
|
|
49
|
+
"Needs a brainId from ounie_list_brains.",
|
|
43
50
|
inputSchema: {
|
|
44
51
|
type: "object",
|
|
45
52
|
properties: {
|
|
@@ -52,7 +59,9 @@ const TOOLS = [
|
|
|
52
59
|
},
|
|
53
60
|
{
|
|
54
61
|
name: "ounie_add_note",
|
|
55
|
-
description: "Add a text note as a
|
|
62
|
+
description: "Add a short verbatim text note as a source (no synthesis). To save a chat " +
|
|
63
|
+
"result or substantial text that should connect into the knowledge graph, " +
|
|
64
|
+
"prefer ounie_add_to_brain instead. Needs a brainId from ounie_list_brains.",
|
|
56
65
|
inputSchema: {
|
|
57
66
|
type: "object",
|
|
58
67
|
properties: {
|
|
@@ -66,7 +75,8 @@ const TOOLS = [
|
|
|
66
75
|
},
|
|
67
76
|
{
|
|
68
77
|
name: "ounie_add_link",
|
|
69
|
-
description: "
|
|
78
|
+
description: "Save a web link as a new source; Ounie fetches and processes the page into " +
|
|
79
|
+
"the brain. Needs a brainId from ounie_list_brains.",
|
|
70
80
|
inputSchema: {
|
|
71
81
|
type: "object",
|
|
72
82
|
properties: {
|
|
@@ -79,9 +89,13 @@ const TOOLS = [
|
|
|
79
89
|
},
|
|
80
90
|
{
|
|
81
91
|
name: "ounie_add_to_brain",
|
|
82
|
-
description: "Save a chat result
|
|
83
|
-
"
|
|
84
|
-
"
|
|
92
|
+
description: "Save a chat result, answer, or any text into an Ounie brain as a durable, " +
|
|
93
|
+
"searchable source. Use when the user says things like 'save this', 'add to " +
|
|
94
|
+
"my brain', or 'remember this'. Default mode='synthesize' rewrites it into a " +
|
|
95
|
+
"wiki page woven into the knowledge graph so it's citable later; use " +
|
|
96
|
+
"mode='note' only to keep the text verbatim. Get the brainId from " +
|
|
97
|
+
"ounie_list_brains first, give a short descriptive title, and pass a stable " +
|
|
98
|
+
"externalId (e.g. a conversation or message id) so retries don't duplicate it.",
|
|
85
99
|
inputSchema: {
|
|
86
100
|
type: "object",
|
|
87
101
|
properties: {
|
|
@@ -105,7 +119,9 @@ const TOOLS = [
|
|
|
105
119
|
},
|
|
106
120
|
{
|
|
107
121
|
name: "ounie_search",
|
|
108
|
-
description: "
|
|
122
|
+
description: "Find and summarize the most relevant saved sources in a brain for a query, " +
|
|
123
|
+
"with citations. Use to locate or recall saved material. Needs a brainId " +
|
|
124
|
+
"from ounie_list_brains.",
|
|
109
125
|
inputSchema: {
|
|
110
126
|
type: "object",
|
|
111
127
|
properties: {
|
|
@@ -116,9 +132,26 @@ const TOOLS = [
|
|
|
116
132
|
additionalProperties: false,
|
|
117
133
|
},
|
|
118
134
|
},
|
|
135
|
+
{
|
|
136
|
+
name: "ounie_get_context",
|
|
137
|
+
description: "Retrieve the most relevant raw saved wiki pages for a query from one brain " +
|
|
138
|
+
"— WITHOUT generating an answer. Prefer this over ounie_ask_brain when YOU " +
|
|
139
|
+
"(the assistant) will read the returned pages and write the answer yourself; " +
|
|
140
|
+
"cite the pages you use by their slug. Cheaper and faster than ounie_ask_brain. " +
|
|
141
|
+
"Needs a brainId from ounie_list_brains.",
|
|
142
|
+
inputSchema: {
|
|
143
|
+
type: "object",
|
|
144
|
+
properties: {
|
|
145
|
+
brainId: { type: "string", description: "The brain's id." },
|
|
146
|
+
query: { type: "string", description: "What to retrieve context about." },
|
|
147
|
+
},
|
|
148
|
+
required: ["brainId", "query"],
|
|
149
|
+
additionalProperties: false,
|
|
150
|
+
},
|
|
151
|
+
},
|
|
119
152
|
];
|
|
120
153
|
// --- Server --------------------------------------------------------------------
|
|
121
|
-
const server = new Server({ name: "ounie-mcp", version: "0.
|
|
154
|
+
const server = new Server({ name: "ounie-mcp", version: "0.3.0" }, { capabilities: { tools: {} } });
|
|
122
155
|
server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools: TOOLS }));
|
|
123
156
|
server.setRequestHandler(CallToolRequestSchema, async (request) => {
|
|
124
157
|
const { name, arguments: args = {} } = request.params;
|
|
@@ -166,6 +199,19 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
|
|
|
166
199
|
.join("\n");
|
|
167
200
|
return text(`${answer.answerMd}\n\n${cites ? `Sources:\n${cites}` : ""}`.trim());
|
|
168
201
|
}
|
|
202
|
+
case "ounie_get_context": {
|
|
203
|
+
const { brainId, query } = args;
|
|
204
|
+
const ctx = await client.getContext(brainId, query);
|
|
205
|
+
if (ctx.thin) {
|
|
206
|
+
return text("No matching sources in this brain yet for that query.");
|
|
207
|
+
}
|
|
208
|
+
const pages = ctx.pages
|
|
209
|
+
.map((p) => `- ${p.title} (${p.slug})`)
|
|
210
|
+
.join("\n");
|
|
211
|
+
return text(`Raw wiki pages from the brain (no answer generated — write the answer ` +
|
|
212
|
+
`yourself and cite pages inline as [[slug]] using the slugs shown):\n\n` +
|
|
213
|
+
`${ctx.contextText}\n\n---\nPages:\n${pages}`);
|
|
214
|
+
}
|
|
169
215
|
default:
|
|
170
216
|
return text(`Unknown tool: ${name}`, true);
|
|
171
217
|
}
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
|