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

1. Clone the repository:

git clone [repository-url]
cd MCP

2. Install dependencies:

npm install

3. Copy the environment variables template:

cp .env.example .env

4. Configure your environment variables in .env:

FEDERATED_DIRECTORY_API_KEY=your_api_key_here

Usage

1. Start the MCP server:

node index.js

2. The server will start and wait for requests from Claude.

3. 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

Error Handling

The server handles various error cases:

• Missing API key
• Invalid search queries
• API request failures
• Network issues

License

This project is licensed under the MIT License - see the LICENSE file for details.