Skip to content

Commit 4a04965

Browse files
peterpeterparkergithub-actions[bot]
peterpeterparker
and
github-actions[bot]
authored
docs: mcp server (#701)
* docs: mcp server Signed-off-by: David Dal Busco <david.dalbusco@outlook.com> * 📄 Update LLMs.txt snapshot for PR review --------- Signed-off-by: David Dal Busco <david.dalbusco@outlook.com> Co-authored-by: github-actions <41898282+github-actions[bot]@users.noreply.github.com>
1 parent 50b7f3b commit 4a04965

3 files changed

Lines changed: 100 additions & 6 deletions

File tree

‎.llms-snapshots/llms-full.txt‎

Lines changed: 44 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -6683,7 +6683,10 @@ It’s a great reference for more advanced setups and orchestration.
66836683

66846684
# Using Juno with AI
66856685

6686-
If you're using AI to build with Juno, you can use our `llms.txt` files to help AI tools better understand the platform.
6686+
Juno provides several ways to integrate with AI tools, from documentation context files to a full MCP server for managing your project through natural language.
6687+
6688+
* ([LLMs.txt](#llmstxt)): help AI tools better understand the platform
6689+
* ([MCP Server](#mcp-server)): interact with Juno directly from your AI tool
66876690

66886691
---
66896692

@@ -6733,14 +6736,53 @@ Type `@Docs` in chat to view available docs and select the Juno entries to begin
67336736

67346737
**Important:**
67356738

6736-
You must reference the Juno docs in chat using `@Docs` — Cursor won't use them otherwise.
6739+
You must reference the Juno docs in chat using `@Docs` - Cursor won't use them otherwise.
67376740

67386741
For example, you could start a conversation with: _I want to create a web shop app with Next.js using @Juno and @Juno (full)._
67396742

67406743
#### Resources
67416744

67426745
Read more in the [Cursor documentation](https://docs.cursor.com/context/@-symbols/@-docs).
67436746

6747+
---
6748+
6749+
## MCP Server
6750+
6751+
A [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) server for Juno is available, built and maintained by a Juno community contributor. It allows MCP-compatible AI tools - such as Claude, Cursor, or VS Code Copilot - to interact with Juno directly through natural language.
6752+
6753+
It provides tools to manage identity, config, hosting, serverless functions, and changes - with built-in access to Juno's documentation. Long-running operations like deploys and publishes support real-time progress streaming.
6754+
6755+
**Note:**
6756+
6757+
This is a community-maintained project. It is not part of the core, but we absolutely 💙 it!
6758+
6759+
### Setup
6760+
6761+
Follow these steps to connect the MCP server to your AI tool of choice.
6762+
6763+
#### 1\. Add to your MCP client
6764+
6765+
No install needed - `npx` handles downloading automatically.
6766+
6767+
```
6768+
{ "mcpServers": { "junobuild": { "command": "npx", "args": ["-y", "junobuild-mcp-server"] } }}
6769+
```
6770+
6771+
#### 2\. Authenticate the Juno CLI
6772+
6773+
The server wraps the [Juno CLI](/docs/reference/cli.md), which must be installed and authenticated:
6774+
6775+
```
6776+
npm i -g @junobuild/clijuno login
6777+
```
6778+
6779+
Once configured, you can interact with Juno directly through your AI tool. Just describe what you want in natural language - for example, _"deploy my satellite"_ or _"list my pending changes"_ - and the AI will call the right tools automatically.
6780+
6781+
### Resources
6782+
6783+
* [npm package](https://www.npmjs.com/package/junobuild-mcp-server)
6784+
* [Source repository](https://github.com/nami2111/junobuild-mcp)
6785+
67446786
# Angular
67456787

67466788
Explore how to create a Juno project developed with Angular.

‎.llms-snapshots/llms.txt‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -104,7 +104,7 @@ Juno is your self-contained serverless platform for building full-stack web apps
104104

105105
## Guides
106106

107-
- [AI](https://juno.build/docs/guides/ai.md): Learn how to use Juno's llms.txt files to provide AI tools with better context for building serverless functions, deploying Satellites, and integrating the SDK.
107+
- [AI](https://juno.build/docs/guides/ai.md): Learn how to use Juno with AI tools, from llms.txt files for better context to an MCP server for managing your project through natural language.
108108
- [Angular](https://juno.build/docs/guides/angular.md): Explore how to create a Juno project developed with Angular.
109109
- [Astro](https://juno.build/docs/guides/astro.md): Explore how to create a Juno project developed with Astro.
110110
- [Docusaurus](https://juno.build/docs/guides/docusaurus.md): Explore how to deploy a Juno project developed with Docusaurus.

‎docs/guides/ai.md‎

Lines changed: 55 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,15 @@
11
---
22
id: ai
33
title: AI
4-
description: Learn how to use Juno's llms.txt files to provide AI tools with better context for building serverless functions, deploying Satellites, and integrating the SDK.
4+
description: Learn how to use Juno with AI tools, from llms.txt files for better context to an MCP server for managing your project through natural language.
55
---
66

77
# Using Juno with AI
88

9-
If you're using AI to build with Juno, you can use our `llms.txt` files to help AI tools better understand the platform.
9+
Juno provides several ways to integrate with AI tools, from documentation context files to a full MCP server for managing your project through natural language.
10+
11+
- [LLMs.txt](#llmstxt): help AI tools better understand the platform
12+
- [MCP Server](#mcp-server): interact with Juno directly from your AI tool
1013

1114
---
1215

@@ -58,7 +61,7 @@ Type `@Docs` in chat to view available docs and select the Juno entries to begin
5861

5962
:::important
6063

61-
You must reference the Juno docs in chat using `@Docs` — Cursor won't use them otherwise.
64+
You must reference the Juno docs in chat using `@Docs` - Cursor won't use them otherwise.
6265

6366
:::
6467

@@ -67,3 +70,52 @@ For example, you could start a conversation with: _I want to create a web shop a
6770
#### Resources
6871

6972
Read more in the [Cursor documentation](https://docs.cursor.com/context/@-symbols/@-docs).
73+
74+
---
75+
76+
## MCP Server
77+
78+
A [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) server for Juno is available, built and maintained by a Juno community contributor. It allows MCP-compatible AI tools - such as Claude, Cursor, or VS Code Copilot - to interact with Juno directly through natural language.
79+
80+
It provides tools to manage identity, config, hosting, serverless functions, and changes - with built-in access to Juno's documentation. Long-running operations like deploys and publishes support real-time progress streaming.
81+
82+
:::note
83+
84+
This is a community-maintained project. It is not part of the core, but we absolutely 💙 it!
85+
86+
:::
87+
88+
### Setup
89+
90+
Follow these steps to connect the MCP server to your AI tool of choice.
91+
92+
#### 1. Add to your MCP client
93+
94+
No install needed - `npx` handles downloading automatically.
95+
96+
```json
97+
{
98+
"mcpServers": {
99+
"junobuild": {
100+
"command": "npx",
101+
"args": ["-y", "junobuild-mcp-server"]
102+
}
103+
}
104+
}
105+
```
106+
107+
#### 2. Authenticate the Juno CLI
108+
109+
The server wraps the [Juno CLI](/docs/reference/cli), which must be installed and authenticated:
110+
111+
```bash
112+
npm i -g @junobuild/cli
113+
juno login
114+
```
115+
116+
Once configured, you can interact with Juno directly through your AI tool. Just describe what you want in natural language - for example, _"deploy my satellite"_ or _"list my pending changes"_ - and the AI will call the right tools automatically.
117+
118+
### Resources
119+
120+
- [npm package](https://www.npmjs.com/package/junobuild-mcp-server)
121+
- [Source repository](https://github.com/nami2111/junobuild-mcp)

0 commit comments

Comments
 (0)