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

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.