Federated Directory MCP

A Model Context Protocol (MCP) server that integrates Claude with the Federated Directory API, allowing for contact searches by name or email address.

Features

Search contacts by name
Search contacts by email address
Comprehensive API request/response logging
Automatic query type detection
Error handling and validation

Prerequisites

Node.js (v18 or higher)
A Federated Directory API key

Installation

Clone the repository:

git clone [repository-url] cd MCP

Install dependencies:

npm install

Copy the environment variables template:

cp .env.example .env

Configure your environment variables in .env:

FEDERATED_DIRECTORY_API_KEY=your_api_key_here

Usage

Start the MCP server:

node index.js

The server will start and wait for requests from Claude.
Example interactions:
Search by name:
Input: "John Smith"
Search by email:
Input: "john@example.com"

API Response Format

The server returns results in the following format:

{ "message": "Here are the contacts matching your search:", "results": [ { "name": "John Smith", "email": "john@example.com", "organization": "Example Corp", "title": "Software Engineer" } ] }

Logging

The server logs all API interactions, including:

Request method, URL, headers, and body
Response status, headers, and body
Search parsing and processing details

Environment Variables

Variable	Description	Required	Default
FEDERATED_DIRECTORY_API_KEY	Your API key for Federated Directory	Yes	-
PORT	Server port number	No	3000
LOG_LEVEL	Logging verbosity	No	info