ServeMyAPI
Un servidor MCP (Protocolo de contexto de modelo) personal para almacenar y acceder de forma segura a claves API en todos los proyectos mediante el llavero de macOS.
IMPORTANTE : ServeMyAPI es una herramienta específica de macOS que utiliza el llavero de macOS para el almacenamiento seguro. No es compatible con los sistemas operativos Windows ni Linux. Consulte la sección de notas de seguridad para obtener más información.
Descripción general
ServeMyAPI le permite almacenar claves API de forma segura en el llavero de macOS y acceder a ellas a través de una interfaz MCP consistente. Esto facilita:
- Almacene las claves API de forma segura (nunca son visibles en archivos .env o archivos de configuración)
- Acceda a las mismas claves en múltiples proyectos
- Utilice lenguaje natural para almacenar y recuperar claves (cuando se utiliza con LLM como Claude)
- Proporcione claves directamente a su asistente de IA cuando necesite acceder a los servicios
¿Por qué ServeMyAPI en lugar de archivos .ENV?
El uso de ServeMyAPI en lugar de los archivos .ENV tradicionales resuelve varios problemas comunes:
- Conflictos de seguridad de GitHub :
- Los archivos .ENV deben excluirse de los repositorios de Git por seguridad (a través de .gitignore)
- Esto crea un problema de "contexto oculto" donde la configuración importante es invisible para los colaboradores y los LLM.
- Los nuevos desarrolladores a menudo tienen dificultades para configurar las variables de entorno correctas
- Desafíos de la integración de LLM :
- Los LLM como Claude no pueden acceder directamente a sus archivos .ENV debido a restricciones de seguridad
- Cuando los LLM necesitan claves API para completar tareas, a menudo se necesitan soluciones manuales alternativas
- ServeMyAPI permite que su asistente de IA solicite claves a través del lenguaje natural
- Coherencia entre proyectos :
- Con archivos .ENV, normalmente es necesario duplicar claves API en varios proyectos
- Cuando cambian las claves, es necesario actualizar varios archivos
- ServeMyAPI proporciona una ubicación de almacenamiento central accesible desde cualquier proyecto
Este enfoque le ofrece lo mejor de ambos mundos: almacenamiento seguro de credenciales confidenciales sin sacrificar la visibilidad y la accesibilidad de sus herramientas de IA.
Características
- Almacenamiento seguro de claves API en el llavero de macOS
- Herramientas MCP sencillas para almacenar, recuperar, enumerar y eliminar claves
- Interfaz CLI conveniente para la gestión de claves basada en terminal
- Compatibilidad con transportes stdio y HTTP/SSE
- Compatible con cualquier cliente MCP (Claude Desktop, etc.)
Instalación
# Clone the repository
git clone https://github.com/yourusername/servemyapi.git
cd servemyapi
# Install dependencies
npm install
# Build the project
npm run build
Uso
Interfaz CLI
ServeMyAPI viene con una interfaz de línea de comandos para una rápida gestión de claves directamente desde su terminal:
# Install the CLI globally
npm run build
npm link
# List all stored API keys
api-key list
# Get a specific API key
api-key get github_token
# Store a new API key
api-key store github_token ghp_123456789abcdefg
# Delete an API key
api-key delete github_token
# Display help
api-key help
Ejecutándose como un servidor stdio
Esta es la forma más sencilla de utilizar ServeMyAPI como servidor MCP, especialmente cuando se trabaja con Claude Desktop:
Ejecutándose como un servidor HTTP
Para aplicaciones que requieren acceso HTTP:
Esto iniciará el servidor en el puerto 3000 (o el puerto especificado en la variable de entorno PORT).
Uso de herrería
ServeMyAPI está disponible como un servicio alojado en Smithery .
import { createTransport } from "@smithery/sdk/transport.js"
const transport = createTransport("https://server.smithery.ai/@Jktfe/servemyapi")
// Create MCP client
import { Client } from "@modelcontextprotocol/sdk/client/index.js"
const client = new Client({
name: "Test client",
version: "1.0.0"
})
await client.connect(transport)
// Use the server tools with your LLM application
const tools = await client.listTools()
console.log(`Available tools: ${tools.map(t => t.name).join(", ")}`)
Para obtener más detalles, consulte la documentación de la API de Smithery .
Configuración de clientes MCP
ServeMyAPI funciona con cualquier cliente compatible con MCP. Se proporcionan archivos de configuración de ejemplo en el directorio examples .
Escritorio de Claude
Para utilizar ServeMyAPI con Claude Desktop:
- Localice o cree el archivo de configuración de Claude Desktop:
- macOS :
~/Library/Application Support/Claude/claude_desktop_config.json - Ventanas :
%AppData%\Claude\claude_desktop_config.json
- Agregue ServeMyAPI a la sección
mcpServers (puede copiar desde examples/claude_desktop_config.json ):{
"mcpServers": {
"serveMyAPI": {
"command": "node",
"args": [
"/ABSOLUTE/PATH/TO/servemyapi/dist/index.js"
]
}
}
}
- Reemplace
/ABSOLUTE/PATH/TO/servemyapi con la ruta real a su instalación de ServeMyAPI. - Reinicie Claude Desktop.
Windsurf
Para utilizar ServeMyAPI con Windsurf:
- Abra el editor Windsurf y navegue hasta Configuración
- Agregue ServeMyAPI a la configuración de su servidor MCP usando el ejemplo en
examples/windsurf_config.json - Adapte las rutas a su instalación local
Herramientas MCP
ServeMyAPI expone las siguientes herramientas:
almacenar-clave-API
Almacene una clave API en la cadena de llaves.
Parámetros:
name : El nombre/identificador de la clave APIkey : La clave API para almacenar
Ejemplo (de Claude):
Using serveMyAPI, store my API key ABC123XYZ as "OpenAI API Key"
obtener clave API
Recupere una clave API del llavero.
Parámetros:
name : El nombre/identificador de la clave API que se recuperará
Ejemplo (de Claude):
Using serveMyAPI, get the API key named "OpenAI API Key"
eliminar clave API
Eliminar una clave API de la cadena de llaves.
Parámetros:
name : El nombre/identificador de la clave API que se eliminará
Ejemplo (de Claude):
Using serveMyAPI, delete the API key named "OpenAI API Key"
lista de claves API
Enumere todas las claves API almacenadas.
No se requieren parámetros.
Ejemplo (de Claude):
Using serveMyAPI, list all my stored API keys
Notas de seguridad
- Todas las claves API se almacenan de forma segura en el llavero de macOS
- Las claves sólo son accesibles para el usuario actual
- El llavero requiere autenticación para acceder.
- No se almacenan claves en texto plano ni se registran en ningún lugar
Hoja de ruta
Los planes futuros para ServeMyAPI incluyen:
- Herramienta de escaneo de código : Esta herramienta escanea automáticamente su base de código en busca de endpoints de API, URL sensibles y variables de entorno, y sugiere nombres para almacenarlos en el llavero. Esto permitirá a los desarrolladores seguir usando archivos .ENV en su flujo de trabajo habitual, a la vez que garantiza que las credenciales también estén disponibles para los LLM y otras herramientas cuando sea necesario.
- Compatibilidad multiplataforma : se investigan opciones de almacenamiento de credenciales seguras para Windows y Linux para que ServeMyAPI sea más accesible.
- Integración con marcos populares : proporciona una fácil integración con marcos como Next.js, Express y otros.
- Interfaz de usuario para gestión de claves : una interfaz web sencilla para gestionar directamente sus claves API almacenadas.
Siéntete libre de sugerir características adicionales o contribuir a la hoja de ruta abriendo un problema o una solicitud de extracción.
Desarrollo
# Run in development mode with hot reload
npm run dev
# Use the CLI during development
npm run cli list
# Lint the code
npm run lint
# Build for production
npm run build
Licencia
Instituto Tecnológico de Massachusetts (MIT)