Analytical MCP

🚀 分析型 MCP 服务器

一个专业的模型上下文协议（MCP）服务器，具备高级分析、研究和自然语言处理功能，能为用户提供全面的数据洞察和文本处理能力。

🚀 快速开始

分析型 MCP 服务器是一款强大的工具，可用于高级数据分析和自然语言处理。以下是快速上手的步骤：

1. 按照安装指南完成服务器的安装和配置。
2. 参考使用说明调用不同的工具和功能。

✨ 主要特性

分析工具

• 数据集分析：对各类数据集进行深入剖析。
• 决策分析：辅助进行科学决策。
• 相关性分析：探究变量间的关联。
• 回归分析：建立变量间的回归模型。
• 时间序列分析：分析时间序列数据。
• 假设检验：验证研究假设。

高级 NLP 功能

• 增强事实提取：精准提取文本中的事实信息。
• 实体识别：识别文本中的实体。
• 参考消解：解决指代不明问题。
• 关系抽取：抽取实体间的关系。
• 情感分析：判断文本的情感倾向。
• 文本相似度计算：计算文本间的相似度。
• 词性标注：标注文本中每个词的词性。
• 词形还原：将单词还原为原形。
• 写检查：检查文本的书写规范。

📦 安装指南

先决条件

• Node.js（v20+）
• npm
• Exa API 密钥（用于研究和高级 NLP 功能）

配置步骤

1. 克隆仓库。
2. 安装依赖项：

   npm install
   

3. 设置环境变量：

   # 复制示例环境文件
   cp .env.example .env
   
   # 编辑 .env 文件并添加您的 API 密钥
   # 您需要一个 Exa API 密钥才能使用研究功能
   

4. 构建项目：

   npm run build
   

💻 使用示例

基础用法

// 分析数据集
const datasetAnalysis = await analyzeDataset([1, 2, 3, 4, 5], 'summary');

// 验证研究声明
const researchVerification = await researchVerification.verifyResearch({
  query: 'Climate change impacts',
  sources: 3
});

// 从文本中提取实体
const entities = await advancedNER.recognizeEntities(
  "Apple Inc. 计划在德克萨斯州奥斯汀开设一个新总部。"
);

高级用法

您可以运行附带的 NLP 演示来查看高级功能：

npm run build
node examples/advanced_nlp_demo.js

📚 详细文档

更多关于 API 和功能的信息请参考：API 文档

🔧 技术细节

可用脚本

• npm run build：编译 TypeScript
• npm test：运行所有测试
• npm run test:integration：仅运行集成测试
• npm run test:exa：运行 Exa 研究 API 测试
• npm run test:research：运行研究验证测试
• npm run test:server：运行服务器工具注册测试
• npm run lint：检查代码质量
• npm run format：格式化代码
• npm run nlp:demo：运行高级 NLP 演示

测试脚本

Unix/Linux/Mac

# 运行所有集成测试并生成摘要报告
./tools/run-all-integration-tests.sh

# 运行特定测试套件
./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

# 运行所有集成测试并生成摘要报告
.\tools\run-all-integration-tests.bat

关键技术

• TypeScript
• 模型上下文协议 SDK
• Exa API（用于研究和 NLP）
• 自然语言处理库
• Jest 测试框架

高级 NLP 实现

分析型 MCP 服务器使用以下方法实现高级 NLP 功能：

• Exa 研究 API 进行上下文感知实体识别。
• 自然语言工具包进行基本 NLP 操作。
• 自定义基于规则的脱机功能作为备用机制。
• 增强事实提取并带有置信度评分。
• 关系抽取和语义网络构建。

环境变量

# 配置文件示例
EXA_API_KEY=your_api_key_here

代码示例

// 示例分析函数
async function analyzeData() {
    try {
        const result = await datasetAnalysis.run();
        console.log(result);
    } catch (error) {
        console.error('分析失败:', error);
    }
}

命令行工具

# 使用内置 CLI 工具进行分析
npx mcp-analyzer --input data.csv --output result.json