MCP-Server hinzufügen

Ein minimaler Model Context Protocol (MCP)-Server, der ein einfaches add(a, b) -Tool bereitstellt. Dieses Projekt dient als grundlegendes Beispiel für eine MCP-Serverimplementierung.

Merkmale

• Implementiert einen Model Context Protocol-kompatiblen Server.

• Bietet ein einzelnes Tool: add(a, b) , das die Summe zweier Zahlen zurückgibt.

Related MCP server: Basic Math MCP Server

Voraussetzungen

• Node.js (Version 18.xx oder höher empfohlen)

• npm (wird mit Node.js geliefert)

Installation

1. Klonen Sie das Repository:

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

2. Installieren Sie Abhängigkeiten:

   npm install

Verwendung

Es gibt mehrere Möglichkeiten, den mcp-add-server auszuführen:

1. Verwenden von npx (für die meisten Benutzer empfohlen):

Wenn Sie Node.js und npm installiert haben, können Sie den Server direkt ausführen, ohne ihn zu klonen oder global zu installieren:

npx mcp-add-server

Dieser Befehl lädt die neueste Version von mcp-add-server herunter (sofern sie nicht bereits zwischengespeichert ist) und führt sie aus.

2. Ausführen aus einem geklonten Repository:

Nach dem Klonen des Repositorys und der Installation der Abhängigkeiten (siehe Installation ):

npm start

Dies verwendet das in package.json definierte start .

3. Globale Installation (für häufige Verwendung oder Entwicklung):

Sie können das Paket global installieren:

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

Anschließend können Sie es von jedem beliebigen Verzeichnis aus ausführen:

mcp-add-server

4. Lokales Verknüpfen für die Entwicklung: Führen Sie im Stammverzeichnis des Projekts npm link aus. Dadurch wird der Befehl mcp-add-server global verfügbar und verweist auf Ihre lokalen Projektdateien.

# In project directory
npm link

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

Sobald der Server läuft (unabhängig von der verwendeten Methode), steht er MCP-Clients zur Verfügung.

Beispiel für einen Tool-Aufruf (konzeptionell)

Ein MCP-Client könnte das add Tool folgendermaßen aufrufen (die Einzelheiten hängen von der Client-Implementierung ab):

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

Der Server würde mit Folgendem antworten:

{
  "result": 8
}

Ausführen von Tests

(Wenn Tests hinzugefügt werden, beschreiben Sie hier, wie sie ausgeführt werden.)

npm test

(Derzeit gibt npm test „Fehler: kein Test angegeben“ aus. Aktualisieren Sie das test in package.json , wenn Tests hinzugefügt werden.)

Projektstruktur

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

Beitragen

Beiträge sind willkommen! Senden Sie gerne einen Pull Request oder melden Sie ein Problem.

Lizenz

Dieses Projekt ist unter der MIT-Lizenz lizenziert.