blah-mcp

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Integrations

  • Mentioned in the roadmap as a planned hosting platform for the MCP server

  • Mentioned as a potential alternative hosting platform for MCP server functions

PROYECTO EN MODO POC EXTREMO - NADA ESTABLE EN ABSOLUTO - LOS DOCUMENTOS Y LA VISIÓN SON SOLO NOTAS

BLAH - Host de agente apenas lógico - Actualización n.° 1

(Piense en npmjs para herramientas)

Una vez que esta lista esté completamente hecha, el esquema BLAH JSON estará finalizado.

  • [ ] Herramientas
    • [x] Funciones locales
    • [x] Funciones alojadas
    • [ ] Registro
      • [ ] Publicar
      • [ ] Navegar
    • [x] Soporte de Mcp
      • [x] Estudio local
      • [x] SSE local
      • [ ] SSE alojado
    • [x] Soporte de holgura
      • [x] Desperdicio local
      • [x] Slop alojado
    • [ ] Componibilidad de herramientas
      • [ ] Agrupación
      • [ ] Flujos
      • [ ] Desencadenantes/Etiquetas
    • [ ] Se extiende
      • [x] Blah.json local
      • [ ] Blah.json alojado
    • [ ] Depuración
      • [ ] Patio de juegos
      • [ ] Registro

Notas:

  • Los flujos utilizarán un subconjunto del esquema de flujo de agnt.gg
  • Extender significa que puedes componer blah.json de cualquier forma que desees. (Piensa qué pasa si solo quieres incluir las herramientas que sigues para los diseñadores)
  • El registro significa que tendremos una forma conveniente de simplemente enviar y recibir funciones (herramientas)

BLAH - Host de agente apenas lógico

BLAH es un ecosistema de código abierto para la gestión, distribución y ejecución de herramientas de agentes de IA mediante el Protocolo de Contexto de Modelo (MCP). Proporciona un registro descentralizado para servidores MCP que promueve la transparencia, la seguridad y el desarrollo comunitario.

Estructura del proyecto

Este proyecto está organizado como un monorepositorio utilizando Turborepo:

  • packages/cli - La principal herramienta CLI de BLAH para trabajar con MCP
  • apps/web - Interfaz web para BLAH
  • apps/docs - Sitio de documentación

Empezando

Prerrequisitos

  • Node.js >= 18.18.0 (se recomienda Node 20+)
  • pnpm

Instalación

# Clone the repository git clone https://github.com/thomasdavis/blah.git cd blah # Install dependencies pnpm install # Build the project pnpm run build

Inicio rápido con la CLI

Consulte el archivo README de la CLI para obtener instrucciones detalladas sobre el uso de la CLI BLAH.

# Navigate to the CLI package cd packages/cli # Set up your environment variables (.env file) echo "OPENAI_API_KEY=your_openai_api_key_here" > .env echo "BLAH_HOST=https://ajax-blah.web.val.run" >> .env # Run a simulation pnpm run simulate

Actualmente trabajando en

  • [ ] Se necesita una forma de depurar servidores mcp usando cualquier modelo/IDE
  • [ ] Piensa en los portales
  • [ ] Lisa Watts inventó "auton", probablemente lo que voy a sugerir.

Ideas no relacionadas

  • [ ] Necesitas guardar el estado en ideas para no perder cosas (si no has confirmado)
  • [ ] votos a favor para herramientas sociales
  • [ ] tasa de error automática
  • [ ] comparte los resultados de tu combinación de herramientas

Usando un blah.json local

Blah.json alojado (Valtown)

Primeros pasos (alojado)

  1. Configurar una cuenta de Valtown
  2. Crea una nueva función HTTP llamada blah
export default async function server(request: Request): Promise<Response> { const tools = [ { name: "hello_name", description: `Says hello to the name`, inputSchema: { type: "object", properties: { name: { type: "string", description: `Name to say hello to`, }, }, }, }, ]; return new Response(JSON.stringify(tools), { headers: { "Content-Type": "application/json", }, status: 200, }); }

Añadiendo a su Cliente

  • Claude
    • De oficina
    • Código (CLI)
  • Cursor
  • Cline
  • Windsurf
  • Cliente BLAH
  • ¿Existen ya buenos clientes web?

Desarrollo

Todavía estoy trabajando en herramientas para que el desarrollo no sea una mierda.

Explotación florestal

Mientras desarrollo esto, quiero enviar registros de todos los clientes para descubrir todos los errores que los clientes están arrojando debido a las diferentes configuraciones.

Patio de juegos

Hasta ahora, solo un cliente básico que enumera indicaciones, recursos y herramientas. Podría ser interactivo más adelante y también debería ejecutarse en pruebas.

npm run playground

Necesita mejorar

  • [ ] Valtown es el contenedor actual, debería haber una alternativa, tal vez usando funciones de Vercel o alguna mierda así.
  • [ ] Se necesita una buena estrategia para la componibilidad.

Créditos

  • Lisa Watts
  • Travis
  • Wombat

MIERDA GENERADA POR IA (lo anterior es auténtico)

  • Insignia de la versión del servidor mcp
  • estado de actividad del registro

¿Qué es BLAH?

BLAH es un ecosistema de código abierto para la gestión, distribución y ejecución de herramientas de agentes de IA mediante el Protocolo de Contexto de Modelo (MCP). Proporciona un registro descentralizado para servidores MCP que no se ve afectado por incentivos desalineados, lo que promueve la transparencia, la seguridad y el desarrollo comunitario.

Características principales:

  • Infraestructura de código abierto a la que cualquier sistema (IDE, plataforma de IA, etc.) puede conectarse
  • Registro de herramientas independiente del idioma que admite una selección ilimitada de herramientas
  • Seguridad robusta mediante firma y verificación opcionales de servidores MCP
  • CLI completa para publicar, descubrir y administrar herramientas
  • Compatibilidad con varios tipos de herramientas: funciones, puntos finales REST, archivos locales o manifiestos estándar

🔍 Visión

BLAH aspira a ser la base de una nueva generación de herramientas de IA que se puedan compartir, descubrir y componer fácilmente. Imaginamos un futuro donde:

  1. Cualquiera puede crear y compartir herramientas que amplíen las capacidades de la IA
  2. Todos tienen acceso a un rico ecosistema de herramientas independientemente de sus antecedentes técnicos.
  3. Cada sistema puede integrarse con este ecosistema a través de protocolos estándar.

🚀 Primeros pasos

Instalación

npm install -g blah-mcp

Uso básico

# Search for tools blah search "image generation" # Install a tool blah install awesome-image-generator # List installed tools blah list # Get info about a tool blah info awesome-image-generator

Conceptos básicos

El Registro

El registro de BLAH está diseñado con lecciones aprendidas de administradores de paquetes como npm, centrándose en:

  • Transparencia : Todo el código de infraestructura es de código abierto.
  • Descentralización : las opciones de almacenamiento incluyen local, nube, IPFS o gists
  • Seguridad : Firma opcional de servidores MCP con verificación
  • Gobernanza : Dirigida por la comunidad, sin una única entidad que controle el ecosistema.

Comportamiento del agente

BLAH admite varios patrones de interacción de agentes:

  • Ejecución paralela
  • Llamadas recursivas a herramientas
  • Flujos de trabajo ramificados
  • Tratamiento secuencial
  • Flujos de trabajo complejos basados en gráficos

Definición de herramienta

Una herramienta en BLAH es fundamentalmente una función, pero se puede representar como:

  • Fragmentos de código
  • Puntos finales RESTful
  • ejecutables locales
  • Manifiestos estándar (SLOP, agents.json)

Cada herramienta debe documentar explícitamente cómo se invoca, aunque esto no es obligatorio.

Comandos CLI

BLAH viene con una CLI completa:

blah publish - Publish a tool to the registry blah search - Search for tools by name, tag, or description blah install - Install a tool blah remove - Remove an installed tool blah update - Update tools to latest versions blah list - List installed tools blah info - Display information about a tool blah config - Configure BLAH settings blah login - Authenticate with registry blah logout - End authentication session blah whoami - Show current authenticated user blah version - Display version information blah help - Show help information

📋 Manifiestos

BLAH utiliza un archivo de manifiesto ( blah.json ) para definir las herramientas y sus dependencias. Este manifiesto puede existir:

  • En un espacio de trabajo del proyecto
  • En el directorio de inicio
  • Alojado en la nube
  • En resumen o en IPFS

Ejemplo blah.json :

{ "name": "awesome-image-generator", "version": "1.0.0", "description": "Tool for generating awesome images", "entry": "./dist/index.js", "tools": [ { "name": "generate_image", "description": "Generates an image from a text prompt", "parameters": { "prompt": { "type": "string", "description": "Text description of the desired image" }, "style": { "type": "string", "enum": ["realistic", "cartoon", "abstract"], "default": "realistic" } } } ], "dependencies": { "image-gen-lib": "^2.0.0" }, "tags": ["image", "generation", "creative"] }

🔄 Soporte de estándares

BLAH apoya y pretende ser compatible con:

  • Protocolo de Contexto Modelo (MCP)
  • SLOP (Estructura para protocolos de operadores de lenguaje)
  • agentes.json
  • [Tus propios protocolos personalizados a través de convertidores]

🌟 Descubrimiento y metadatos

Las herramientas en BLAH se organizan utilizando:

  • Etiquetas (por ejemplo, #TOOLBELT)
  • Metadatos semánticos para una navegación intuitiva
  • Análisis de uso para recomendaciones basadas en popularidad
  • Recomendaciones basadas en el usuario (herramientas utilizadas por usuarios similares)

🏗️ Arquitectura

BLAH consta de tres componentes principales:

  1. Registro : para el almacenamiento y descubrimiento de herramientas
  2. CLI : Para interactuar con el registro y administrar herramientas
  3. Servidor MCP : para ejecutar herramientas dentro de los flujos de trabajo del agente

Actualmente, ValTown funciona como backend principal para el almacenamiento y el cómputo del registro, aunque se aceptan implementaciones alternativas.

🔒 Seguridad y Responsabilidad

BLAH se toma la seguridad muy en serio:

  • Firma opcional de servidores MCP
  • Ejecución de código en entornos sandbox
  • Registro exhaustivo para la rendición de cuentas
  • Cumplimiento de las leyes y normativas locales

🚧 Hoja de ruta

  • [ ] Alojar el servidor MCP en plataformas en la nube (por ejemplo, Cloudflare Workers)
  • [ ] Crear un explorador de herramientas y un sitio de documentación basados en la web
  • [ ] Mejorar la depuración y la experiencia del desarrollador
  • [ ] Desarrollar un asistente/generador de creación de herramientas
  • [ ] Implementar un sistema de recomendación de herramientas

🧠 Ideas futuras

  • Intercambio de comportamiento del usuario para recomendaciones de herramientas personalizadas
  • Ejecución programada del agente a través de mecanismos similares a cron
  • Modelo de gobernanza descentralizada para la gestión de registros
  • Ecosistema de extensión para implementaciones de registros personalizados

🤝 Contribuyendo

¡Agradecemos sus contribuciones! Vuelva pronto para consultar las pautas detalladas.

Créditos

Un agradecimiento especial a Lisa y Wombat por sus invaluables contribuciones a este proyecto.

📄 Licencia

BLAH se publica bajo la licencia MIT. Consulte el archivo de licencia para más detalles.


ID: mzhi2jsx0x