@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 CHANGED
@@ -1,6 +1,6 @@
1
1
  MIT License
2
2
 
3
- Copyright (c) 2026 Pipeworx
3
+ Copyright (c) 2026 Mojibake Inc.
4
4
 
5
5
  Permission is hereby granted, free of charge, to any person obtaining a copy
6
6
  of this software and associated documentation files (the "Software"), to deal
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 1173+ live data sources.
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
- Or connect to the full Pipeworx gateway for access to all 1173+ data sources:
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
- - [All tools and guides](https://github.com/pipeworx-io/examples)
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.0",
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.7.0"
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
@@ -3,7 +3,7 @@
3
3
  "name": "io.github.pipeworx-io/emoji",
4
4
  "title": "Emoji",
5
5
  "description": "Emoji MCP.",
6
- "version": "0.1.0",
6
+ "version": "0.1.1",
7
7
  "websiteUrl": "https://pipeworx.io/packs/emoji",
8
8
  "repository": {
9
9
  "url": "https://github.com/pipeworx-io/mcp-emoji",
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
  }