Analytical

GitHub
Integrates with
Exa

Analytical MCP Server

A specialized Model Context Protocol (MCP) server providing advanced analytical, research, and natural language processing capabilities.

Key Features

Analytical Tools

  • Dataset Analysis
  • Decision Analysis
  • Correlation Analysis
  • Regression Analysis
  • Time Series Analysis
  • Hypothesis Testing

Advanced NLP Capabilities

  • Enhanced Fact Extraction
  • Named Entity Recognition
  • Coreference Resolution
  • Relationship Extraction
  • Sentiment Analysis
  • Text Similarity
  • Part of Speech Tagging
  • Lemmatization
  • Spell Checking

Installation

Prerequisites

  • Node.js (v20+)
  • npm
  • Exa API key (for research and advanced NLP capabilities)

Setup

  1. Clone the repository
  2. Install dependencies: 
    npm install
  3. Set up your environment variables: 
    # Copy the example environment file
cp .env.example .env

# Edit .env and add your API keys
# You'll need an Exa API key for research functionality
  4. Build the project: 
    npm run build

Usage

Running Tools

Each tool can be invoked with specific parameters. Example:

// Analyze a dataset
const datasetAnalysis = await analyzeDataset([1, 2, 3, 4, 5], 'summary');

// Verify research claims
const researchVerification = await researchVerification.verifyResearch({
  query: 'Climate change impacts',
  sources: 3
});

// Extract entities from text
const entities = await advancedNER.recognizeEntities(
  "Apple Inc. is planning to open a new headquarters in Austin, Texas."
);

Advanced NLP Demo

You can run the included NLP demo to see the advanced capabilities in action:

npm run build
node examples/advanced_nlp_demo.js

Development

Available Scripts

  • npm run build: Compile TypeScript
  • npm test: Run all tests
  • npm run test:integration: Run integration tests only
  • npm run test:exa: Run Exa Research API tests
  • npm run test:research: Run Research Verification tests
  • npm run test:server: Run Server Tool Registration tests
  • npm run lint: Check code quality
  • npm run format: Format code
  • npm run nlp:demo: Run advanced NLP demo

Test Scripts

We provide dedicated scripts for running specific test suites:

Unix/Linux/Mac
## Run all integration tests with a summary report
./tools/run-all-integration-tests.sh

## Run specific test suites
./tools/run-exa-tests.sh
./tools/run-research-tests.sh
./tools/run-server-tests.sh
./tools/run-api-key-tests.sh
./tools/run-data-pipeline-tests.sh
./tools/run-market-analysis-tests.sh
Windows
## Run all integration tests with a summary report
.\tools\run-all-integration-tests.bat

Key Technologies

  • TypeScript
  • Model Context Protocol SDK
  • Exa API for Research and NLP
  • Natural Language Processing libraries
  • Jest for Testing

Advanced NLP Implementation

The Analytical MCP Server implements advanced NLP features using:

  • Exa research API for context-aware entity recognition
  • Natural language toolkit for basic NLP operations
  • Custom rule-based fallback mechanisms for offline capabilities
  • Enhanced fact extraction with confidence scoring
  • Relationship extraction between entities

For detailed information, see the Advanced NLP documentation.

Required API Keys

This project requires the following API key:

  • EXA_API_KEY: Used for research integration and advanced NLP

The .env.example file contains all available configuration options:

  • API keys
  • Feature flags
  • Cache settings
  • NLP configuration
  • Server configuration

Copy this file to .env in your project root and update with your actual API keys to get started.

Contributing

  1. Fork the repository
  2. Create a feature branch
  3. Commit your changes
  4. Push to the branch
  5. Create a Pull Request

License

MIT License