Analytical MCP

🚀 Analytical MCP Server

A professional Model Context Protocol (MCP) server that offers advanced analysis, research, and natural language processing capabilities.

✨ Features

Analytical Tools

• Dataset analysis
• Decision analysis
• Correlation analysis
• Regression analysis
• Time series analysis
• Hypothesis testing

Advanced NLP Capabilities

• Enhanced fact extraction
• Entity recognition
• Coreference resolution
• Relationship extraction
• Sentiment analysis
• Text similarity calculation
• Part-of-speech tagging
• Lemmatization
• Writing check

📦 Installation

Prerequisites

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

Configuration Steps

1. Clone the repository.
2. Install dependencies:

   npm install
   

3. Set environment variables:

   # Copy the example environment file
   cp .env.example .env
   
   # Edit the .env file and add your API key
   # You need an Exa API key to use the research capabilities
   

4. Build the project:

   npm run build
   

💻 Usage Examples

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 a research claim
const researchVerification = await researchVerification.verifyResearch({
  query: 'Climate change impacts',
  sources: 3
});

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

Advanced NLP Demonstration

You can run the included NLP demonstration to view advanced capabilities:

npm run build
node examples/advanced_nlp_demo.js

📚 Documentation

Available Scripts

• npm run build: Compile TypeScript.
• npm test: Run all tests.
• npm run test:integration: Run only integration tests.
• 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 the advanced NLP demonstration.

Test Scripts

We provide dedicated scripts to run specific test suites:

Unix/Linux/Mac

# Run all integration tests and generate 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 and generate 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 library
• Jest testing framework

🔧 Technical Details

The Analytical MCP Server implements advanced NLP capabilities using the following methods:

• Exa research API for context-aware entity recognition
• Natural Language Toolkit for basic NLP operations
• Custom rule-based offline capabilities as a fallback mechanism
• Enhanced fact extraction with confidence scores
• Relationship extraction and semantic network construction

Environment Variables

# Example configuration file
EXA_API_KEY=your_api_key_here

Code Examples

// Example analysis function
async function analyzeData() {
    try {
        const result = await datasetAnalysis.run();
        console.log(result);
    } catch (error) {
        console.error('Analysis failed:', error);
    }
}

Command-Line Tools

# Use the built-in CLI tool for analysis
npx mcp-analyzer --input data.csv --output result.json

Detailed Documentation

For more information about the API and capabilities, refer to: API Documentation