npm @homespunapps/mcpstreamable-httpMITupdated 10d ago
Apps your AI builds and hosts, for you and the people you invite.
O que dá para fazer com Homespun?
Homespun
Apps your AI builds and hosts, for you and the people you invite.
An agent creates a real web app from a single HTML file plus a manifest, and Homespun hosts it at a URL. People open the link and use it. No install, no build step, no deploy pipeline.
Docs: docs.homespun.dev
What is in this repository
The client side, all MIT licensed:
| Package | What it is |
|---|---|
@homespunapps/cli |
The homespun command line client |
@homespunapps/mcp |
The MCP server, so an agent can drive Homespun as a tool |
@homespunapps/core |
Shared client library and types |
Plus the agent skill (skills/homespun) and the Claude plugin
(plugins/homespun).
The relay, which is the hosted server these clients talk to, is not open source and is not in this repository.
Getting started
npm install -g @homespunapps/cli
homespun agent register
homespun deploy ./my-app
./my-app needs an index.html and a manifest.json. The
quickstart walks through both.
To use Homespun from a chat client such as Claude or ChatGPT instead of a terminal, see Connect to your AI chat, which needs no install at all.
Reference
Every reference page below is generated from the source it documents, and a test fails the build when the two disagree.
- HTTP API, every
/v1endpoint - CLI, every command and flag
- SDK, the
window.homespunbrowser API - Manifest, the app manifest format
- Errors, every error code
- Agent guide and MCP guide
Contributing
This repository is a read-only mirror. See CONTRIBUTING.md.
License
MIT. See LICENSE.
Instalação
Adicione Homespun ao seu cliente. Escolha o que você usa.
{
"servers": {
"mcp": {
"type": "http",
"url": "https://homespun.dev/mcp"
}
}
}Add to `.vscode/mcp.json` in your workspace.
claude mcp add mcp -- npx -y @homespunapps/mcpcodex mcp add mcp -- npx -y @homespunapps/mcpamp mcp add mcp -- npx -y @homespunapps/mcp{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@homespunapps/mcp"
]
}
}
}Add to `claude_desktop_config.json`, then restart Claude Desktop.
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@homespunapps/mcp"
]
}
}
}Add to `~/.cursor/mcp.json`, or `.cursor/mcp.json` for a single project.
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@homespunapps/mcp"
]
}
}
}Add to `~/.codeium/windsurf/mcp_config.json`.
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@homespunapps/mcp"
]
}
}
}Add to `cline_mcp_settings.json` via the MCP Servers panel.
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@homespunapps/mcp"
]
}
}
}Add to `~/.gemini/settings.json`.
{
"mcpServers": {
"mcp": {
"type": "local",
"command": "npx",
"args": [
"-y",
"@homespunapps/mcp"
],
"tools": [
"*"
]
}
}
}Add to `~/.copilot/mcp-config.json`, or run `/mcp add` inside the CLI.
{
"context_servers": {
"mcp": {
"command": {
"path": "npx",
"args": [
"-y",
"@homespunapps/mcp"
]
}
}
}
}Add to your Zed `settings.json`.
npx -y @homespunapps/mcpRun `goose configure`, choose **Add Extension → Command-line Extension**, and paste this command.
Pontuação
39 / 100
Incompleta
- Documentação13/25
- Manutenção25/25
- Confiança16/20
- Capacidade0/15
- Instalação15/15
- Documents what it does and how to connect
- Has a resolvable package or endpoint
- Exposes at least one tool, prompt or resource
- README has substantive content
- Includes a code example
- Documents its configuration
- Mentions credentials or security posture
- Last commit 3 days ago
- Has a release history
- Repository is not archived
- Licensed MIT
- Namespace verified in the official MCP registry
- Claimed by its owner
- Published under an organisation
- 0 tool(s) documented
- Provides prompt templates
- Provides resources
- 18 documented install method(s)
- Published to a package registry
- Offers a hosted endpoint — no local install
Histórico de versões
| Versões | Publicada |
|---|---|
| 1.6.59 | 12 de ago. de 2026 |
| 1.6.58 | 11 de ago. de 2026 |
| 1.6.57 | 10 de ago. de 2026 |
| 1.6.56 | 9 de ago. de 2026 |
| 1.6.55 | 9 de ago. de 2026 |
| 1.6.54 | 8 de ago. de 2026 |
| 1.6.53 | 8 de ago. de 2026 |
| 1.6.52 | 7 de ago. de 2026 |
| 1.6.51 | 7 de ago. de 2026 |
| 1.6.50 | 7 de ago. de 2026 |
| 1.6.49 | 6 de ago. de 2026 |
| 1.6.48 | 5 de ago. de 2026 |
| 1.6.47 | 5 de ago. de 2026 |
| 1.6.46 | 5 de ago. de 2026 |
| 1.6.45 | 4 de ago. de 2026 |
| 1.6.44 | 4 de ago. de 2026 |
| 1.6.43 | 4 de ago. de 2026 |
| 1.6.42 | 2 de ago. de 2026 |
| 1.6.41 | 1 de ago. de 2026 |
| 1.6.40 | 1 de ago. de 2026 |
| 1.6.39 | 31 de jul. de 2026 |
| 1.6.38 | 31 de jul. de 2026 |
| 1.6.37 | 31 de jul. de 2026 |
| 1.6.36 | 31 de jul. de 2026 |
| 1.6.35 | 31 de jul. de 2026 |
| 1.6.34 | 30 de jul. de 2026 |
| 1.6.33 | 30 de jul. de 2026 |
| 1.6.32 | 30 de jul. de 2026 |
| 1.6.31 | 30 de jul. de 2026 |
| 1.6.30 | 30 de jul. de 2026 |
| 1.6.29 | 30 de jul. de 2026 |
| 1.6.28 | 30 de jul. de 2026 |
| 1.6.27 | 30 de jul. de 2026 |
| 1.6.26 | 29 de jul. de 2026 |
| 1.6.25 | 29 de jul. de 2026 |
| 1.6.24 | 29 de jul. de 2026 |
| 1.6.23 | 29 de jul. de 2026 |
| 1.6.22 | 28 de jul. de 2026 |
| 1.6.21 | 28 de jul. de 2026 |
| 1.6.20 | 28 de jul. de 2026 |
| 1.6.19 | 28 de jul. de 2026 |
| 1.6.18 | 28 de jul. de 2026 |
| 1.6.17 | 28 de jul. de 2026 |
| 1.6.16 | 28 de jul. de 2026 |
| 1.6.15 | 28 de jul. de 2026 |
| 1.6.14 | 27 de jul. de 2026 |
| 1.6.13 | 27 de jul. de 2026 |
| 1.6.12 | 26 de jul. de 2026 |
| 1.6.11 | 26 de jul. de 2026 |
| 1.6.10 | 26 de jul. de 2026 |
| 1.6.6 | 26 de jul. de 2026 |
| 1.6.5 | 25 de jul. de 2026 |
| 1.6.4 | 25 de jul. de 2026 |
| 1.6.3 | 25 de jul. de 2026 |
| 1.6.2 | 24 de jul. de 2026 |
| 1.6.1 | 23 de jul. de 2026 |
| 1.6.0 | 23 de jul. de 2026 |
| 1.5.1 | 22 de jul. de 2026 |
| 1.5.0 | 22 de jul. de 2026 |
| 1.4.3 | 22 de jul. de 2026 |