@pipeworx/mcp-emoji 0.1.0 → 0.1.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/LICENSE +1 -1
- package/README.md +63 -4
- package/bin/cli.js +17 -0
- package/package.json +15 -3
- package/server.json +1 -1
- package/src/index.ts +8 -0
- package/src/server.ts +45 -0
- package/tsconfig.json +5 -1
package/LICENSE
CHANGED
package/README.md
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
Emoji MCP.
|
|
4
4
|
|
|
5
|
-
Part of [Pipeworx](https://pipeworx.io) — an MCP gateway connecting AI agents to
|
|
5
|
+
Part of [Pipeworx](https://pipeworx.io) — an MCP gateway connecting AI agents to 1679+ live data sources.
|
|
6
6
|
|
|
7
7
|
## Tools
|
|
8
8
|
|
|
@@ -25,7 +25,25 @@ Add to your MCP client (Claude Desktop, Cursor, Windsurf, etc.):
|
|
|
25
25
|
}
|
|
26
26
|
```
|
|
27
27
|
|
|
28
|
-
|
|
28
|
+
### What this endpoint actually serves
|
|
29
|
+
|
|
30
|
+
`tools/list` at `https://gateway.pipeworx.io/emoji/mcp` returns the tools in the table
|
|
31
|
+
above **plus the shared Pipeworx meta-tools** — `ask_pipeworx`,
|
|
32
|
+
`discover_tools`, `search_within`, `remember`/`recall` and the rest of the
|
|
33
|
+
gateway-wide set. So the tool count you see is larger than this table: a
|
|
34
|
+
single-pack endpoint currently lists roughly 30 shared tools alongside the
|
|
35
|
+
pack's own. The connection's `initialize` response states its exact scope, and
|
|
36
|
+
is the authoritative answer for a given day.
|
|
37
|
+
|
|
38
|
+
This is deliberate, not multiplexing by accident. The meta-tools are what let a
|
|
39
|
+
scoped connection answer a question this pack does not cover — via
|
|
40
|
+
`ask_pipeworx`, which routes across the whole catalog — without you adding a
|
|
41
|
+
second MCP server. There is currently no way to mount a pack endpoint without
|
|
42
|
+
them; if the extra schemas cost you more context than the routing is worth,
|
|
43
|
+
connect to the full gateway once rather than to several pack endpoints.
|
|
44
|
+
|
|
45
|
+
Or connect to the full Pipeworx gateway to get every pack's tools listed
|
|
46
|
+
directly, instead of just this one's:
|
|
29
47
|
|
|
30
48
|
```json
|
|
31
49
|
{
|
|
@@ -37,9 +55,50 @@ Or connect to the full Pipeworx gateway for access to all 1173+ data sources:
|
|
|
37
55
|
}
|
|
38
56
|
```
|
|
39
57
|
|
|
58
|
+
Both URLs reach the same gateway and the same 1679+ data sources. The
|
|
59
|
+
only difference is which pack's tools are listed **directly**; `ask_pipeworx`
|
|
60
|
+
reaches all of them from either one.
|
|
61
|
+
|
|
62
|
+
## No MCP client? Call it over HTTP
|
|
63
|
+
|
|
64
|
+
```bash
|
|
65
|
+
curl -X POST https://gateway.pipeworx.io/v1/tools/emoji_lookup \
|
|
66
|
+
-H 'Content-Type: application/json' \
|
|
67
|
+
-d '{"input":":fire:"}'
|
|
68
|
+
```
|
|
69
|
+
|
|
70
|
+
No account needed for the first calls. Inspect any tool: `GET https://gateway.pipeworx.io/v1/tools/emoji_lookup`. Find one: `POST https://gateway.pipeworx.io/v1/tools/search_packs` with `{"query":"..."}`.
|
|
71
|
+
|
|
72
|
+
## Standalone (no gateway account)
|
|
73
|
+
|
|
74
|
+
This package also runs as a local stdio MCP server — no Pipeworx account, no
|
|
75
|
+
gateway round-trip:
|
|
76
|
+
|
|
77
|
+
```json
|
|
78
|
+
{
|
|
79
|
+
"mcpServers": {
|
|
80
|
+
"emoji": {
|
|
81
|
+
"command": "npx",
|
|
82
|
+
"args": ["-y", "@pipeworx/mcp-emoji"]
|
|
83
|
+
}
|
|
84
|
+
}
|
|
85
|
+
}
|
|
86
|
+
```
|
|
87
|
+
|
|
88
|
+
Or run it directly to confirm it starts:
|
|
89
|
+
|
|
90
|
+
```bash
|
|
91
|
+
npx -y @pipeworx/mcp-emoji
|
|
92
|
+
```
|
|
93
|
+
|
|
94
|
+
It speaks MCP over stdin/stdout and answers `initialize`/`tools/list`/`tools/call`
|
|
95
|
+
for **only** this pack's tools — none of the shared meta-tools the gateway
|
|
96
|
+
connection above adds. Same source, same tools, no ask_pipeworx routing.
|
|
97
|
+
|
|
40
98
|
## Using with ask_pipeworx
|
|
41
99
|
|
|
42
|
-
Instead of calling tools directly, you can ask questions in plain English
|
|
100
|
+
Instead of calling tools directly, you can ask questions in plain English —
|
|
101
|
+
this works on the pack endpoint above as well as on the full gateway:
|
|
43
102
|
|
|
44
103
|
```
|
|
45
104
|
ask_pipeworx({ question: "your question about Emoji data" })
|
|
@@ -49,7 +108,7 @@ The gateway picks the right tool and fills the arguments automatically.
|
|
|
49
108
|
|
|
50
109
|
## More
|
|
51
110
|
|
|
52
|
-
- [
|
|
111
|
+
- [Docs and guides](https://pipeworx.io/docs)
|
|
53
112
|
- [pipeworx.io](https://pipeworx.io)
|
|
54
113
|
|
|
55
114
|
## License
|
package/bin/cli.js
ADDED
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
//
|
|
3
|
+
// Entry point for `npx @pipeworx/mcp-<slug>`.
|
|
4
|
+
//
|
|
5
|
+
// Packs ship as raw TypeScript (no build step — see publish-pack.sh for why:
|
|
6
|
+
// tsx sidesteps every extensionless-import / bare-JSON-import edge case a
|
|
7
|
+
// per-pack tsc build would have to solve one pack at a time). This file
|
|
8
|
+
// registers tsx's ESM loader programmatically, then hands off to src/server.ts,
|
|
9
|
+
// which wraps the pack's {tools, callTool} export in a stdio MCP server.
|
|
10
|
+
//
|
|
11
|
+
// Copied verbatim into every published pack repo by scripts/publish-pack.sh —
|
|
12
|
+
// edit this file, not a per-pack copy.
|
|
13
|
+
import { register } from 'tsx/esm/api';
|
|
14
|
+
|
|
15
|
+
register();
|
|
16
|
+
|
|
17
|
+
await import('../src/server.ts');
|
package/package.json
CHANGED
|
@@ -1,20 +1,32 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@pipeworx/mcp-emoji",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.1",
|
|
4
4
|
"description": "Emoji MCP.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "src/index.ts",
|
|
7
7
|
"types": "src/index.ts",
|
|
8
|
+
"bin": {
|
|
9
|
+
"mcp-emoji": "bin/cli.js"
|
|
10
|
+
},
|
|
8
11
|
"keywords": ["mcp", "mcp-server", "model-context-protocol", "pipeworx", "emoji"],
|
|
9
12
|
"license": "MIT",
|
|
10
13
|
"repository": {
|
|
11
14
|
"type": "git",
|
|
12
|
-
"url": "https://github.com/pipeworx-io/mcp-emoji"
|
|
15
|
+
"url": "git+https://github.com/pipeworx-io/mcp-emoji.git"
|
|
13
16
|
},
|
|
14
17
|
"scripts": {
|
|
15
18
|
"typecheck": "tsc --noEmit"
|
|
16
19
|
},
|
|
20
|
+
"dependencies": {
|
|
21
|
+
"@modelcontextprotocol/sdk": "^1.30.0",
|
|
22
|
+
"tsx": "^4.19.0"
|
|
23
|
+
},
|
|
17
24
|
"devDependencies": {
|
|
18
|
-
"typescript": "^5.
|
|
25
|
+
"typescript": "^5.9.3",
|
|
26
|
+
"@cloudflare/workers-types": "^4.20260405.1"
|
|
27
|
+
},
|
|
28
|
+
"pipeworx": {
|
|
29
|
+
"sourceHash": "v1-f8fd279502161d14b1fbfcb0549fb621366b7278ae9eac09b927371b72f1c7c9",
|
|
30
|
+
"sourceCommit": "76aa8f5d9b5dc2f665563030647c68e661478864"
|
|
19
31
|
}
|
|
20
32
|
}
|
package/server.json
CHANGED
package/src/index.ts
CHANGED
|
@@ -1,11 +1,19 @@
|
|
|
1
1
|
interface McpToolDefinition {
|
|
2
2
|
name: string;
|
|
3
3
|
description: string;
|
|
4
|
+
/** Human-facing one-liner (fleet #1967). Optional; consumers fall back to
|
|
5
|
+
* description. Kept in step with shared/src/types.ts — scripts/lib/
|
|
6
|
+
* check-inlined-types.mjs reports drift at publish time. */
|
|
7
|
+
summary?: string;
|
|
4
8
|
inputSchema: {
|
|
5
9
|
type: 'object';
|
|
6
10
|
properties: Record<string, unknown>;
|
|
7
11
|
required?: string[];
|
|
12
|
+
anyOf?: Array<{ required: string[] }>;
|
|
13
|
+
oneOf?: Array<{ required: string[] }>;
|
|
14
|
+
allOf?: Array<{ required: string[] }>;
|
|
8
15
|
};
|
|
16
|
+
outputSchema?: Record<string, unknown>;
|
|
9
17
|
}
|
|
10
18
|
|
|
11
19
|
interface McpToolExport {
|
package/src/server.ts
ADDED
|
@@ -0,0 +1,45 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Stdio MCP server entry point for @pipeworx/mcp-emoji.
|
|
3
|
+
* Generated by scripts/publish-pack.sh — do not hand-edit in the pack repo;
|
|
4
|
+
* edit scripts/publish-pack.sh (the server.ts heredoc) and republish instead.
|
|
5
|
+
*/
|
|
6
|
+
import { Server } from '@modelcontextprotocol/sdk/server/index.js';
|
|
7
|
+
import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
|
|
8
|
+
import { CallToolRequestSchema, ListToolsRequestSchema } from '@modelcontextprotocol/sdk/types.js';
|
|
9
|
+
import pack from './index.js';
|
|
10
|
+
|
|
11
|
+
const server = new Server(
|
|
12
|
+
{ name: '@pipeworx/mcp-emoji', version: '0.1.1' },
|
|
13
|
+
{ capabilities: { tools: {} } },
|
|
14
|
+
);
|
|
15
|
+
|
|
16
|
+
server.setRequestHandler(ListToolsRequestSchema, async () => ({
|
|
17
|
+
tools: pack.tools.map((t) => ({
|
|
18
|
+
name: t.name,
|
|
19
|
+
description: t.description,
|
|
20
|
+
inputSchema: t.inputSchema,
|
|
21
|
+
})),
|
|
22
|
+
}));
|
|
23
|
+
|
|
24
|
+
server.setRequestHandler(CallToolRequestSchema, async (request) => {
|
|
25
|
+
const { name, arguments: args } = request.params;
|
|
26
|
+
try {
|
|
27
|
+
const result = await pack.callTool(name, (args ?? {}) as Record<string, unknown>);
|
|
28
|
+
return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
|
|
29
|
+
} catch (err) {
|
|
30
|
+
return {
|
|
31
|
+
content: [{ type: 'text', text: err instanceof Error ? err.message : String(err) }],
|
|
32
|
+
isError: true,
|
|
33
|
+
};
|
|
34
|
+
}
|
|
35
|
+
});
|
|
36
|
+
|
|
37
|
+
async function main() {
|
|
38
|
+
const transport = new StdioServerTransport();
|
|
39
|
+
await server.connect(transport);
|
|
40
|
+
}
|
|
41
|
+
|
|
42
|
+
main().catch((err) => {
|
|
43
|
+
console.error('Fatal error running server:', err);
|
|
44
|
+
process.exit(1);
|
|
45
|
+
});
|
package/tsconfig.json
CHANGED
|
@@ -3,12 +3,16 @@
|
|
|
3
3
|
"target": "ES2022",
|
|
4
4
|
"module": "ESNext",
|
|
5
5
|
"moduleResolution": "bundler",
|
|
6
|
+
"lib": ["ES2022"],
|
|
7
|
+
"types": ["@cloudflare/workers-types"],
|
|
6
8
|
"strict": true,
|
|
7
9
|
"esModuleInterop": true,
|
|
8
10
|
"skipLibCheck": true,
|
|
11
|
+
"resolveJsonModule": true,
|
|
9
12
|
"outDir": "dist",
|
|
10
13
|
"rootDir": "src",
|
|
11
14
|
"declaration": true
|
|
12
15
|
},
|
|
13
|
-
"include": ["src"]
|
|
16
|
+
"include": ["src"],
|
|
17
|
+
"exclude": ["src/server.ts"]
|
|
14
18
|
}
|