nanmesh-mcp 1.0.1 → 1.0.2
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 +106 -0
- package/package.json +1 -1
package/README.md
ADDED
|
@@ -0,0 +1,106 @@
|
|
|
1
|
+
# nanmesh-mcp
|
|
2
|
+
|
|
3
|
+
MCP server for [NaN Mesh](https://nanmesh.ai) — the AI-native product catalog built for agent-to-agent discovery.
|
|
4
|
+
|
|
5
|
+
Gives Claude access to verified B2B software products with trust signals, confidence scores, and structured agent cards. Instead of relying on training data or web search, Claude queries owner-maintained, up-to-date product data directly.
|
|
6
|
+
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
## Quick Start
|
|
10
|
+
|
|
11
|
+
**1. Run the server**
|
|
12
|
+
```bash
|
|
13
|
+
npx nanmesh-mcp
|
|
14
|
+
```
|
|
15
|
+
|
|
16
|
+
The terminal will show your config — copy and paste it into your Claude Desktop config file.
|
|
17
|
+
|
|
18
|
+
**2. Add to Claude Desktop**
|
|
19
|
+
|
|
20
|
+
| OS | Config file location |
|
|
21
|
+
|----|---------------------|
|
|
22
|
+
| Mac | `~/Library/Application Support/Claude/claude_desktop_config.json` |
|
|
23
|
+
| Windows | `%APPDATA%\Claude\claude_desktop_config.json` |
|
|
24
|
+
|
|
25
|
+
```json
|
|
26
|
+
{
|
|
27
|
+
"mcpServers": {
|
|
28
|
+
"nanmesh": {
|
|
29
|
+
"command": "npx",
|
|
30
|
+
"args": ["nanmesh-mcp"],
|
|
31
|
+
"env": {
|
|
32
|
+
"NANMESH_API_URL": "https://api.nanmesh.ai"
|
|
33
|
+
}
|
|
34
|
+
}
|
|
35
|
+
}
|
|
36
|
+
}
|
|
37
|
+
```
|
|
38
|
+
|
|
39
|
+
**3. Restart Claude Desktop**
|
|
40
|
+
|
|
41
|
+
That's it. Claude can now search and recommend products from the NaN Mesh catalog.
|
|
42
|
+
|
|
43
|
+
---
|
|
44
|
+
|
|
45
|
+
## What Claude can do
|
|
46
|
+
|
|
47
|
+
Once connected, ask Claude things like:
|
|
48
|
+
|
|
49
|
+
- *"Find me a CRM that works for small teams"*
|
|
50
|
+
- *"What analytics tools are on NaN Mesh?"*
|
|
51
|
+
- *"Recommend a developer tool under $50/month"*
|
|
52
|
+
- *"What are the trust signals for product X?"*
|
|
53
|
+
|
|
54
|
+
---
|
|
55
|
+
|
|
56
|
+
## Available Tools
|
|
57
|
+
|
|
58
|
+
| Tool | What it does |
|
|
59
|
+
|------|-------------|
|
|
60
|
+
| `search_products` | Full-text search across the catalog — returns confidence scores, pricing, and exclusion signals |
|
|
61
|
+
| `recommend_products` | AI-ranked recommendations for a use case — includes reasoning and `not_recommended_for` signals |
|
|
62
|
+
| `get_agent_card` | Full structured profile for a product — pricing plans, use cases, verification badges, trust signals |
|
|
63
|
+
| `list_products` | Browse all products, optionally filtered by category |
|
|
64
|
+
| `get_categories` | List all product categories with counts |
|
|
65
|
+
| `get_products_changed_since` | Fetch products updated after a given timestamp — useful for keeping agent context fresh |
|
|
66
|
+
| `get_discovery_report` | Platform-level stats: total products, categories, verified count |
|
|
67
|
+
| `submit_feedback` | Submit a structured rating and review after evaluating a product — closes the recommendation loop |
|
|
68
|
+
|
|
69
|
+
---
|
|
70
|
+
|
|
71
|
+
## Trust Signals
|
|
72
|
+
|
|
73
|
+
Every product in NaN Mesh includes:
|
|
74
|
+
|
|
75
|
+
- **`ai_confidence_score`** — 0.0–1.0, how complete and verified the product data is. Only recommend products with score ≥ 0.7.
|
|
76
|
+
- **`not_recommended_for`** — explicit exclusion signals from the product owner. Always check this before recommending.
|
|
77
|
+
- **`verification_badges`** — website live, pricing confirmed, company verified.
|
|
78
|
+
- **`recommendation_momentum`** — how often other agents have recommended this product.
|
|
79
|
+
|
|
80
|
+
Ranking formula: `ai_confidence_score (40%) + verification_badges (30%) + recommendation_momentum (20%) + view_count (10%)`
|
|
81
|
+
|
|
82
|
+
---
|
|
83
|
+
|
|
84
|
+
## Environment Variables
|
|
85
|
+
|
|
86
|
+
| Variable | Default | Description |
|
|
87
|
+
|----------|---------|-------------|
|
|
88
|
+
| `NANMESH_API_URL` | `http://localhost:8000` | NaN Mesh backend URL. Use `https://api.nanmesh.ai` for production. |
|
|
89
|
+
| `NANMESH_API_KEY` | *(none)* | Optional API key for write operations (submitting feedback). |
|
|
90
|
+
|
|
91
|
+
---
|
|
92
|
+
|
|
93
|
+
## Add to Claude Code (CLI)
|
|
94
|
+
|
|
95
|
+
```bash
|
|
96
|
+
claude mcp add nanmesh -e NANMESH_API_URL=https://api.nanmesh.ai -- npx nanmesh-mcp
|
|
97
|
+
```
|
|
98
|
+
|
|
99
|
+
---
|
|
100
|
+
|
|
101
|
+
## Links
|
|
102
|
+
|
|
103
|
+
- **Platform:** [nanmesh.ai](https://nanmesh.ai)
|
|
104
|
+
- **API docs:** [api.nanmesh.ai/docs](https://api.nanmesh.ai/docs)
|
|
105
|
+
- **Agent discovery (A2A):** [api.nanmesh.ai/.well-known/agent.json](https://api.nanmesh.ai/.well-known/agent.json)
|
|
106
|
+
- **npm:** [npmjs.com/package/nanmesh-mcp](https://npmjs.com/package/nanmesh-mcp)
|