Agregar servidor MCP

Un servidor de Protocolo de Contexto de Modelo (MCP) minimalista que proporciona una herramienta sencilla add(a, b) . Este proyecto sirve como ejemplo básico de la implementación de un servidor MCP.

Características

• Implementa un servidor compatible con el Protocolo de Contexto de Modelo.

• Proporciona una única herramienta: add(a, b) que devuelve la suma de dos números.

Related MCP server: Basic Math MCP Server

Prerrequisitos

• Node.js (versión 18.xx o superior recomendada)

• npm (viene con Node.js)

Instalación

1. Clonar el repositorio:

   git clone <你的仓库URL> # 当你推送到 GitHub 后，替换这里的 URL
   cd mcp-add-server

2. Instalar dependencias:

   npm install

Uso

Hay varias formas de ejecutar mcp-add-server :

1. Usando npx (recomendado para la mayoría de los usuarios):

Si tiene Node.js y npm instalados, puede ejecutar el servidor directamente sin clonar ni instalar globalmente:

npx mcp-add-server

Este comando descargará la última versión de mcp-add-server (si aún no está en caché) y la ejecutará.

2. Ejecución desde un repositorio clonado:

Después de clonar el repositorio e instalar las dependencias (ver Instalación ):

npm start

Esto utiliza el script start definido en package.json .

3. Instalación global (para uso frecuente o desarrollo):

Puede instalar el paquete globalmente:

npm install -g .  # From the cloned repository directory
# or once published to npm:
# npm install -g mcp-add-server

Luego puedes ejecutarlo desde cualquier directorio:

mcp-add-server

4. Enlace local para desarrollo: En el directorio raíz del proyecto, ejecute npm link . Esto hará que el comando mcp-add-server esté disponible globalmente, apuntando a los archivos locales del proyecto.

# In project directory
npm link

# Then, in any directory:
mcp-add-server

Una vez que el servidor esté en funcionamiento (independientemente del método utilizado), estará disponible para los clientes de MCP.

Ejemplo de llamada a herramienta (conceptual)

Un cliente MCP podría llamar a la herramienta add de esta manera (los detalles dependen de la implementación del cliente):

{
  "tool_name": "add",
  "arguments": {
    "a": 5,
    "b": 3
  }
}

El servidor respondería con:

{
  "result": 8
}

Ejecución de pruebas

(Cuando se agreguen pruebas, describa aquí cómo ejecutarlas)

npm test

(Actualmente, npm test mostrará el mensaje "Error: no se especificó ninguna prueba". Actualice el script test en package.json cuando se agreguen pruebas).

Estructura del proyecto

mcp-add-server/
├── .git/               # Git directory
├── .gitignore          # Specifies intentionally untracked files that Git should ignore
├── .cursor/            # Cursor specific files (if any)
├── node_modules/       # Project dependencies
├── src/                # Source code
│   └── server.js       # Main server logic
├── bin.js              # Executable for the server
├── LICENSE             # Project license
├── package-lock.json   # Records exact versions of dependencies
├── package.json        # Project metadata and dependencies
└── README.md           # This file

Contribuyendo

¡Agradecemos sus contribuciones! No dude en enviar una solicitud de incorporación de cambios o abrir un problema.

Licencia

Este proyecto está licenciado bajo la licencia MIT .