graphor 0.12.0 → 0.12.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/CHANGELOG.md +13 -0
- package/README.md +70 -54
- package/package.json +1 -1
- package/src/version.ts +1 -1
- package/version.d.mts +1 -1
- package/version.d.ts +1 -1
- package/version.js +1 -1
- package/version.mjs +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,18 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
+
## 0.12.1 (2026-02-13)
|
|
4
|
+
|
|
5
|
+
Full Changelog: [v0.12.0...v0.12.1](https://github.com/synapseops/graphor-typescript-sdk/compare/v0.12.0...v0.12.1)
|
|
6
|
+
|
|
7
|
+
### Chores
|
|
8
|
+
|
|
9
|
+
* **internal:** improve reliability of MCP servers when using local code mode execution ([088cc77](https://github.com/synapseops/graphor-typescript-sdk/commit/088cc7775d6fc9f840f63a7585d5535b88710f02))
|
|
10
|
+
|
|
11
|
+
|
|
12
|
+
### Documentation
|
|
13
|
+
|
|
14
|
+
* update mcp docs ([22683c4](https://github.com/synapseops/graphor-typescript-sdk/commit/22683c46548ef9daede772880cbfe45ffd2c3217))
|
|
15
|
+
|
|
3
16
|
## 0.12.0 (2026-02-12)
|
|
4
17
|
|
|
5
18
|
Full Changelog: [v0.11.4...v0.12.0](https://github.com/synapseops/graphor-typescript-sdk/compare/v0.11.4...v0.12.0)
|
package/README.md
CHANGED
|
@@ -13,60 +13,6 @@ The official TypeScript SDK for the [Graphor](https://graphorlm.com) API. Build
|
|
|
13
13
|
- 🔒 **Type Safety** — Complete TypeScript definitions for all params and responses
|
|
14
14
|
- 🌐 **Multi-Runtime** — Works in Node.js, Deno, Bun, and browsers
|
|
15
15
|
|
|
16
|
-
## MCP Server
|
|
17
|
-
|
|
18
|
-
Use the Graphor MCP Server to enable AI assistants to interact with this API, allowing them to explore endpoints, make test requests, and use documentation to help integrate this SDK into your application.
|
|
19
|
-
|
|
20
|
-
[](https://cursor.com/en-US/install-mcp?name=graphor-mcp&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsImdyYXBob3ItbWNwIl0sImVudiI6eyJHUkFQSE9SX0FQSV9LRVkiOiJNeSBBUEkgS2V5In19)
|
|
21
|
-
[](https://vscode.stainless.com/mcp/%7B%22name%22%3A%22graphor-mcp%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22graphor-mcp%22%5D%2C%22env%22%3A%7B%22GRAPHOR_API_KEY%22%3A%22My%20API%20Key%22%7D%7D)
|
|
22
|
-
|
|
23
|
-
> Note: You may need to set environment variables in your MCP client.
|
|
24
|
-
|
|
25
|
-
### Remote MCP Server (Web Apps & Agentic Workflows)
|
|
26
|
-
|
|
27
|
-
For web-based AI clients (e.g. [Claude.ai](https://claude.ai)) or agentic frameworks (e.g. LangChain, CrewAI) that cannot run local `npx` processes, use the hosted remote MCP server. Authentication is handled via **OAuth** — a browser window will open for you to log in.
|
|
28
|
-
|
|
29
|
-
```
|
|
30
|
-
https://mcp.graphor.workers.dev/sse
|
|
31
|
-
```
|
|
32
|
-
|
|
33
|
-
**Web apps (e.g. Claude.ai)** — in Claude.ai, go to **Settings > Connectors > Add custom connector**, fill in the name and the remote MCP server URL. You will be redirected to log in through the OAuth flow:
|
|
34
|
-
|
|
35
|
-
```
|
|
36
|
-
https://mcp.graphor.workers.dev/sse
|
|
37
|
-
```
|
|
38
|
-
|
|
39
|
-
**Desktop clients (e.g. Claude Desktop)** — use [`mcp-remote`](https://www.npmjs.com/package/mcp-remote) as a local proxy:
|
|
40
|
-
|
|
41
|
-
```json
|
|
42
|
-
{
|
|
43
|
-
"mcpServers": {
|
|
44
|
-
"graphor_api": {
|
|
45
|
-
"command": "npx",
|
|
46
|
-
"args": ["mcp-remote", "https://mcp.graphor.workers.dev/sse"]
|
|
47
|
-
}
|
|
48
|
-
}
|
|
49
|
-
}
|
|
50
|
-
```
|
|
51
|
-
|
|
52
|
-
**Agentic workflows (e.g. LangChain)** — connect via SSE transport:
|
|
53
|
-
|
|
54
|
-
```typescript
|
|
55
|
-
import { MultiServerMCPClient } from "@langchain/mcp-adapters";
|
|
56
|
-
|
|
57
|
-
const client = new MultiServerMCPClient({
|
|
58
|
-
graphor: {
|
|
59
|
-
url: "https://mcp.graphor.workers.dev/sse",
|
|
60
|
-
transport: "sse",
|
|
61
|
-
}
|
|
62
|
-
});
|
|
63
|
-
|
|
64
|
-
const tools = await client.getTools();
|
|
65
|
-
// Use tools with your LangChain agent
|
|
66
|
-
```
|
|
67
|
-
|
|
68
|
-
See the [MCP Server README](./packages/mcp-server/README.md) for more details.
|
|
69
|
-
|
|
70
16
|
## Documentation
|
|
71
17
|
|
|
72
18
|
📚 **Full documentation**: [docs.graphorlm.com/sdk/overview](https://docs.graphorlm.com/sdk/overview)
|
|
@@ -417,6 +363,76 @@ const chunks = await client.sources.retrieveChunks({
|
|
|
417
363
|
console.log(`🔍 Found ${chunks.total} relevant chunks`);
|
|
418
364
|
```
|
|
419
365
|
|
|
366
|
+
## MCP Server
|
|
367
|
+
|
|
368
|
+
Use the Graphor MCP Server to enable AI assistants to interact with this API, allowing them to explore endpoints, make test requests, and use documentation to help integrate this SDK into your application.
|
|
369
|
+
|
|
370
|
+
[](https://cursor.com/en-US/install-mcp?name=graphor-mcp&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsImdyYXBob3ItbWNwIl0sImVudiI6eyJHUkFQSE9SX0FQSV9LRVkiOiJNeSBBUEkgS2V5In19)
|
|
371
|
+
[](https://vscode.stainless.com/mcp/%7B%22name%22%3A%22graphor-mcp%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22graphor-mcp%22%5D%2C%22env%22%3A%7B%22GRAPHOR_API_KEY%22%3A%22My%20API%20Key%22%7D%7D)
|
|
372
|
+
|
|
373
|
+
Or manually add it to your MCP client's configuration:
|
|
374
|
+
|
|
375
|
+
```json
|
|
376
|
+
{
|
|
377
|
+
"mcpServers": {
|
|
378
|
+
"graphor_api": {
|
|
379
|
+
"command": "npx",
|
|
380
|
+
"args": ["-y", "graphor-mcp@latest"],
|
|
381
|
+
"env": {
|
|
382
|
+
"GRAPHOR_API_KEY": "grlm_your_api_key_here"
|
|
383
|
+
}
|
|
384
|
+
}
|
|
385
|
+
}
|
|
386
|
+
}
|
|
387
|
+
```
|
|
388
|
+
|
|
389
|
+
> Note: You may need to set environment variables in your MCP client.
|
|
390
|
+
|
|
391
|
+
### Remote MCP Server (Web Apps & Agentic Workflows)
|
|
392
|
+
|
|
393
|
+
For web-based AI clients (e.g. [Claude.ai](https://claude.ai)) or agentic frameworks (e.g. LangChain, CrewAI) that cannot run local `npx` processes, use the hosted remote MCP server. Authentication is handled via **OAuth** — a browser window will open for you to log in.
|
|
394
|
+
|
|
395
|
+
```
|
|
396
|
+
https://mcp.graphor.workers.dev/sse
|
|
397
|
+
```
|
|
398
|
+
|
|
399
|
+
**Web apps (e.g. Claude.ai)** — in Claude.ai, go to **Settings > Connectors > Add custom connector**, fill in the name and the remote MCP server URL. You will be redirected to log in through the OAuth flow:
|
|
400
|
+
|
|
401
|
+
```
|
|
402
|
+
https://mcp.graphor.workers.dev/sse
|
|
403
|
+
```
|
|
404
|
+
|
|
405
|
+
**Desktop clients (e.g. Claude Desktop)** — use [`mcp-remote`](https://www.npmjs.com/package/mcp-remote) as a local proxy:
|
|
406
|
+
|
|
407
|
+
```json
|
|
408
|
+
{
|
|
409
|
+
"mcpServers": {
|
|
410
|
+
"graphor_api": {
|
|
411
|
+
"command": "npx",
|
|
412
|
+
"args": ["mcp-remote", "https://mcp.graphor.workers.dev/sse"]
|
|
413
|
+
}
|
|
414
|
+
}
|
|
415
|
+
}
|
|
416
|
+
```
|
|
417
|
+
|
|
418
|
+
**Agentic workflows (e.g. LangChain)** — connect via SSE transport:
|
|
419
|
+
|
|
420
|
+
```typescript
|
|
421
|
+
import { MultiServerMCPClient } from "@langchain/mcp-adapters";
|
|
422
|
+
|
|
423
|
+
const client = new MultiServerMCPClient({
|
|
424
|
+
graphor: {
|
|
425
|
+
url: "https://mcp.graphor.workers.dev/sse",
|
|
426
|
+
transport: "sse",
|
|
427
|
+
}
|
|
428
|
+
});
|
|
429
|
+
|
|
430
|
+
const tools = await client.getTools();
|
|
431
|
+
// Use tools with your LangChain agent
|
|
432
|
+
```
|
|
433
|
+
|
|
434
|
+
See the [MCP Server README](./packages/mcp-server/README.md) for more details.
|
|
435
|
+
|
|
420
436
|
## API Reference
|
|
421
437
|
|
|
422
438
|
### Sources
|
package/package.json
CHANGED
package/src/version.ts
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
export const VERSION = '0.12.
|
|
1
|
+
export const VERSION = '0.12.1'; // x-release-please-version
|
package/version.d.mts
CHANGED
|
@@ -1,2 +1,2 @@
|
|
|
1
|
-
export declare const VERSION = "0.12.
|
|
1
|
+
export declare const VERSION = "0.12.1";
|
|
2
2
|
//# sourceMappingURL=version.d.mts.map
|
package/version.d.ts
CHANGED
|
@@ -1,2 +1,2 @@
|
|
|
1
|
-
export declare const VERSION = "0.12.
|
|
1
|
+
export declare const VERSION = "0.12.1";
|
|
2
2
|
//# sourceMappingURL=version.d.ts.map
|
package/version.js
CHANGED
package/version.mjs
CHANGED
|
@@ -1,2 +1,2 @@
|
|
|
1
|
-
export const VERSION = '0.12.
|
|
1
|
+
export const VERSION = '0.12.1'; // x-release-please-version
|
|
2
2
|
//# sourceMappingURL=version.mjs.map
|