تكامل MCP مع IBM Bob

{
  "name": "arxiv-server",
  "version": "0.1.0",
  "description": "MCP server for read-only access to arXiv papers",
  "type": "module",
  "bin": {
    "arxiv-server": "./build/index.js"
  },
  "files": [
    "build"
  ],
  "scripts": {
    "build": "tsc && node -e \"require('fs').chmodSync('build/index.js', '755')\"",
    "prepare": "npm run build",
    "watch": "tsc --watch"
  },
  "keywords": [
    "mcp",
    "arxiv",
    "research",
    "papers"
  ],
  "dependencies": {
    "@modelcontextprotocol/sdk": "^1.0.4",
    "axios": "^1.7.9",
    "zod": "^3.24.1"
  },
  "devDependencies": {
    "@types/node": "^22.10.5",
    "typescript": "^5.7.3"
  }
}

{
  "compilerOptions": {
    "target": "ES2022",
    "module": "Node16",
    "moduleResolution": "Node16",
    "outDir": "./build",
    "rootDir": "./src",
    "strict": true,
    "esModuleInterop": true,
    "skipLibCheck": true,
    "forceConsistentCasingInFileNames": true,
    "resolveJsonModule": true,
    "declaration": true
  },
  "include": ["src/**/*"],
  "exclude": ["node_modules", "build"]
}

#!/usr/bin/env node
import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
import { z } from "zod";
import axios from 'axios';

// Define types for arXiv API responses
interface ArxivEntry {
  id: string;
  title: string;
  summary: string;
  authors: Array<{ name: string }>;
  published: string;
  updated: string;
  categories: string[];
  primary_category: string;
  links: Array<{ href: string; rel: string; type?: string }>;
}

interface ArxivSearchResult {
  entries: ArxivEntry[];
  totalResults: number;
  startIndex: number;
  itemsPerPage: number;
}

// Create an MCP server
const server = new McpServer({
  name: "arxiv-server",
  version: "0.1.0"
});

// Create axios instance for arXiv API
const arxivApi = axios.create({
  baseURL: 'http://export.arxiv.org/api',
  timeout: 30000,
});

/**
 * Parse arXiv API XML response to JSON
 */
function parseArxivXML(xmlData: string): ArxivSearchResult {
  const entries: ArxivEntry[] = [];
  
  // Extract total results
  const totalResultsMatch = xmlData.match(/<opensearch:totalResults[^>]*>(\d+)<\/opensearch:totalResults>/);
  const totalResults = totalResultsMatch ? parseInt(totalResultsMatch[1]) : 0;
  
  const startIndexMatch = xmlData.match(/<opensearch:startIndex[^>]*>(\d+)<\/opensearch:startIndex>/);
  const startIndex = startIndexMatch ? parseInt(startIndexMatch[1]) : 0;
  
  const itemsPerPageMatch = xmlData.match(/<opensearch:itemsPerPage[^>]*>(\d+)<\/opensearch:itemsPerPage>/);
  const itemsPerPage = itemsPerPageMatch ? parseInt(itemsPerPageMatch[1]) : 0;
  
  // Extract entries
  const entryRegex = /<entry>([\s\S]*?)<\/entry>/g;
  let entryMatch;
  
  while ((entryMatch = entryRegex.exec(xmlData)) !== null) {
    const entryXml = entryMatch[1];
    
    // Extract ID
    const idMatch = entryXml.match(/<id>([^<]+)<\/id>/);
    const id = idMatch ? idMatch[1] : '';
    
    // Extract title
    const titleMatch = entryXml.match(/<title>([^<]+)<\/title>/);
    const title = titleMatch ? titleMatch[1].trim().replace(/\s+/g, ' ') : '';
    
    // Extract summary
    const summaryMatch = entryXml.match(/<summary>([^<]+)<\/summary>/);
    const summary = summaryMatch ? summaryMatch[1].trim().replace(/\s+/g, ' ') : '';
    
    // Extract authors
    const authors: Array<{ name: string }> = [];
    const authorRegex = /<author>\s*<name>([^<]+)<\/name>/g;
    let authorMatch;
    while ((authorMatch = authorRegex.exec(entryXml)) !== null) {
      authors.push({ name: authorMatch[1].trim() });
    }
    
    // Extract published date
    const publishedMatch = entryXml.match(/<published>([^<]+)<\/published>/);
    const published = publishedMatch ? publishedMatch[1] : '';
    
    // Extract updated date
    const updatedMatch = entryXml.match(/<updated>([^<]+)<\/updated>/);
    const updated = updatedMatch ? updatedMatch[1] : '';
    
    // Extract categories
    const categories: string[] = [];
    const categoryRegex = /<category[^>]+term="([^"]+)"/g;
    let categoryMatch;
    while ((categoryMatch = categoryRegex.exec(entryXml)) !== null) {
      categories.push(categoryMatch[1]);
    }
    
    const primary_category = categories[0] || '';
    
    // Extract links
    const links: Array<{ href: string; rel: string; type?: string }> = [];
    const linkRegex = /<link[^>]+href="([^"]+)"[^>]+rel="([^"]+)"(?:[^>]+type="([^"]+)")?/g;
    let linkMatch;
    while ((linkMatch = linkRegex.exec(entryXml)) !== null) {
      links.push({
        href: linkMatch[1],
        rel: linkMatch[2],
        type: linkMatch[3]
      });
    }
    
    entries.push({
      id,
      title,
      summary,
      authors,
      published,
      updated,
      categories,
      primary_category,
      links
    });
  }
  
  return {
    entries,
    totalResults,
    startIndex,
    itemsPerPage
  };
}

/**
 * Format search results for display
 */
function formatSearchResults(result: ArxivSearchResult): string {
  let output = `Found ${result.totalResults} results (showing ${result.entries.length})\n\n`;
  
  result.entries.forEach((entry, index) => {
    output += `${index + 1}. ${entry.title}\n`;
    output += `   ID: ${entry.id}\n`;
    output += `   Authors: ${entry.authors.map(a => a.name).join(', ')}\n`;
    output += `   Published: ${entry.published}\n`;
    output += `   Categories: ${entry.categories.join(', ')}\n`;
    output += `   Abstract: ${entry.summary.substring(0, 300)}${entry.summary.length > 300 ? '...' : ''}\n`;
    
    // Find abstract link (not PDF)
    const abstractLink = entry.links.find(l => l.rel === 'alternate');
    if (abstractLink) {
      output += `   URL: ${abstractLink.href}\n`;
    }
    output += '\n';
  });
  
  return output;
}

// Add a tool for searching arXiv papers
server.tool(
  "search_arxiv",
  {
    query: z.string().describe("Search query (supports arXiv query syntax)"),
    max_results: z.number().min(1).max(50).optional().describe("Maximum number of results to return (1-50, default: 10)"),
    start: z.number().min(0).optional().describe("Starting index for pagination (default: 0)"),
    sort_by: z.enum(["relevance", "lastUpdatedDate", "submittedDate"]).optional().describe("Sort order (default: relevance)"),
    sort_order: z.enum(["ascending", "descending"]).optional().describe("Sort direction (default: descending)")
  },
  async ({ query, max_results = 10, start = 0, sort_by = "relevance", sort_order = "descending" }) => {
    try {
      // Enforce reasonable limits
      const limitedMaxResults = Math.min(max_results, 50);
      const limitedStart = Math.max(start, 0);
      
      // Build query parameters
      const params: Record<string, string | number> = {
        search_query: query,
        start: limitedStart,
        max_results: limitedMaxResults,
      };
      
      if (sort_by) {
        params.sortBy = sort_by;
      }
      
      if (sort_order) {
        params.sortOrder = sort_order;
      }
      
      const response = await arxivApi.get('/query', { params });
      
      // Parse XML response
      const result = parseArxivXML(response.data);
      
      // Format results
      const formattedResults = formatSearchResults(result);
      
      return {
        content: [
          {
            type: "text",
            text: formattedResults,
          },
        ],
      };
    } catch (error) {
      if (axios.isAxiosError(error)) {
        return {
          content: [
            {
              type: "text",
              text: `arXiv API error: ${error.response?.data?.message ?? error.message}`,
            },
          ],
          isError: true,
        };
      }
      throw error;
    }
  }
);

// Start receiving messages on stdin and sending messages on stdout
const transport = new StdioServerTransport();
await server.connect(transport);
console.error('arXiv MCP server running on stdio');

// Made with Bob

{ 
	"mcpServers": {}
	"mcpServers": { 
		"arxiv": { 
			"command": "node", 
			"args": [ "/here/is/the/path/to/arxiv-server/build/index.js" 
				], 
			"disabled": false, 
			"alwaysAllow": [], 
			"disabledTools": [] 
		} 
	}
}

kind: mcp
name: arxiv-toolkit
description: مجموعة أدوات للبحث في الأوراق البحثية على arXiv. توفِّر إمكانية الوصول إلى بيانات الأوراق البحثية الوصفية والملخصات ومعلومات النشر من قاعدة بيانات arXiv.
package_root: /local/path/to/arxiv-server
language: node
command: node /local/path/to/arxiv-server/arxiv-server/build/index.js
tools:
- "*"
# Made with Bob

name: research-assistant
kind: native
description: مساعد بحثي يعتمد على الذكاء الاصطناعي يساعد في العثور على الأوراق الأكاديمية من arXiv وتلخيصها. متخصص في البحث في الأدبيات العلمية وشرح نتائج الأبحاث وتقديم الاستشهادات المرجعية.
title: Research Assistant
instructions: |
أنت مساعد بحثي خبير ومتخصص في البحث في الأدبيات الأكاديمية على arXiv.
## إمكاناتك
- البحث في arXiv عن أوراق بحثية في أي مجال علمي.
- تلخيص نتائج الأبحاث استنادًا إلى الملخصات بلغة مبسَّطة.
- تحديد أبرز المؤلفين والتوجُّهات البحثية.
- اقتراح أوراق وموضوعات ذات صلة.
- تقديم استشهادات صحيحة تتضمن معرِّفات arXiv وروابط الأوراق. ## عند الرد على المستخدمين
1. قدِّم دائمًا معرِّفات arXiv والروابط المباشرة للأوراق.
2. لخِّص الملخصات بلغة سهلة الفهم.
3. سلِّط الضوء على أهم المساهمات والنتائج.
4. اقترِح عمليات بحث متابعة عند الاقتضاء.
5. كُن موجزًا مع الحفاظ على الفائدة. ## استخدام أداة search_arxiv
المعاملات المتاحة:
- query (إلزامي): استعلام البحث باستخدام صيغة arXiv.
- max_results (اختياري): من 1 إلى 50 ورقة، والقيمة الافتراضية 10.
- start (اختياري): فهرس البداية للترقيم، والقيمة الافتراضية 0.
- sort_by (اختياري): "relevance" أو "submittedDate" أو "lastUpdatedDate".
- sort_order (اختياري): "ascending" أو "descending".
## صيغة البحث المتقدمة
يمكنك استخدام المعاملات التالية:
- ti:keyword - البحث في العنوان.
- au:author - البحث باسم المؤلف.
- abs:keyword - البحث في الملخص.
- cat:category - التصفية حسب الفئة (مثل cs.AI أو quant-ph أو math.CO).
- AND وOR وANDNOT - معاملات منطقية.
أمثلة:
- "ti:transformer AND cat:cs.LG" - أوراق عن Transformer في مجال التعلم الآلي.
- "au:Hinton" - أوراق Geoffrey Hinton.
- "quantum computing AND cat:quant-ph" - الحوسبة الكمِّية ضمن فيزياء الكم.
## الفئات الشائعة
- cs.AI - الذكاء الاصطناعي.
- cs.LG - التعلم الآلي.
- cs.CL - معالجة اللغة الطبيعية.
- cs.CV - رؤية الكمبيوتر.
- quant-ph - فيزياء الكم.
- math.CO - التوافقيات.
- stat.ML - التعلم الآلي (الإحصاء).
## تنسيق الاستجابة
عند عرض الأوراق البحثية، استخدِم التنسيق التالي:
**"عنوان الورقة"**
- المؤلفون: [أسماء المؤلفين]
- تاريخ النشر: [التاريخ]
- الفئات: [الفئات]
- الملخص: [ملخص موجز]
- [عرض الورقة](arXiv URL)
## التعامل مع الحالات الخاصة
- إذا لم يتم العثور على نتائج: فاقترِح مصطلحات بحث بديلة أو استعلامات أوسع.
- إذا كانت النتائج كثيرة: فقم بالتوصية بتضييق نطاق البحث باستخدام الفئات أو التاريخ.
- إذا طلب المستخدم ملفات PDF: فوضِّح أنك توفِّر البيانات الوصفية فقط، مع تضمين الرابط الذي يمكنه من خلاله الوصول إلى الورقة.
- إذا كان الاستعلام غير واضح: فاطرح أسئلة توضيحية حول المجال البحثي أو الاهتمامات المحددة.

tools:
- search_arxiv

config:
hidden: false
enable_cot: true

tags:
- research
- academic
- papers
- arxiv
- literature-search

# Made with Bob.