Tool4lm

🚀 TOOL4LM — 本地大語言模型的多功能MCP服務器

TOOL4LM是一款強大的MCP（模型上下文協議）服務器，由Node.js和TypeScript編寫，專為本地運行的大語言模型（如LM Studio、Ollama等）提供豐富的工具支持。它集成了網頁搜索、網頁讀取與總結、內部文檔搜索與讀取、學術檢索以及計算等功能，且默認無需API密鑰，能顯著提升本地或遠程大語言模型的使用效率和體驗。

🚀 快速開始

按照以下步驟安裝並運行TOOL4LM：

npm install
npm run build
npm start

當成功運行時，會輸出如下信息： [TOOL4LM] started. Sandbox: <沙盒路徑>

✨ 主要特性

• 🔎 網頁搜索：支持多源搜索（SearXNG + DuckDuckGo HTML），自動去重，返回標題、URL和摘要。
• 🌐 網頁抓取/讀取：可在限制大小和時間的情況下下載網頁（防止服務器端請求偽造），並提取“可讀”文本進行總結。
• 📂 文檔搜索/讀取：能在沙盒目錄中搜索並讀取文檔（支持txt、md、html、pdf格式）。對於PDF文件，使用pdf-parse進行懶加載。
• 📚 學術搜索/獲取：支持學術檢索（arXiv + Crossref + Wikipedia），並可根據DOI/arXivId獲取論文元數據。
• 🧮 計算器：使用mathjs評估表達式，支持設置精度（四捨五入）。

📦 安裝指南

安裝依賴並啟動服務

npm install
npm run build
npm start

LM Studio的MCP配置

在LM Studio的mcp.json文件中添加以下配置：

{
  "mcpServers": {
    "TOOL4LM": {
      "command": "node",
      "args": ["--enable-source-maps", "C:/path/to/tool4lm/dist/server.js"],
      "type": "mcp",
      "env": {
        "SANDBOX_DIR": "C:/path/to/your_docs",
        "SEARXNG_ENDPOINTS": "https://searx.be/search,https://searx.tiekoetter.com/search",
        "ENGINE_ORDER": "searxng,duckduckgo",
        "LANG_DEFAULT": "vi",
        "REGION_DEFAULT": "vn",
        "MAX_FETCH_BYTES": "1048576",
        "FETCH_TIMEOUT_MS": "8000"
      }
    }
  }
}

⚠️ 重要提示 在Windows系統中，建議在JSON文件中使用/來避免對\進行轉義。

💻 使用示例

網頁搜索引用流程

web.search → web.fetch → web.read → 總結並附加URL。

內部文檔處理流程

doc.find → doc.read → 總結並引用段落（附上path）。

學術檢索流程

sch.search → 根據DOI/arXivId使用sch.get。

計算操作

使用calc.eval，支持^/pow(a,b)（或已規範化的**）。

📚 詳細文檔

工具與參數（主名稱 ⇄ 下劃線別名）

💡 使用建議 由於已開啟openWorldHint，即使模型意外添加了額外字段，服務器仍會接受；但建議按照表格中的參數準確使用，以確保穩定性。

環境變量

• SANDBOX_DIR — 文檔目錄（默認：./sandbox）。
• SEARXNG_ENDPOINTS — SearXNG的/search端點列表，用逗號分隔。
• ENGINE_ORDER — 例如searxng,duckduckgo。
• LANG_DEFAULT, REGION_DEFAULT — 網頁搜索時的語言/地區建議。
• MAX_FETCH_BYTES — 網頁下載大小限制。
• FETCH_TIMEOUT_MS — 網頁下載超時時間（毫秒）。

🤝 貢獻

非常歡迎提交問題（Issues）和拉取請求（PRs）！如果發現任何問題或有相關建議，請幫忙創建一個問題。

📄 許可證

本項目採用MIT許可證。

☕ 支持

如果您覺得這個項目有用，可以通過PayPal支持我：

或者點擊下面的按鈕：