Js MCP Server

🚀 JS MCP 服務器

JS MCP 服務器是一個基於 JavaScript 的 MCP 服務器組件，它集成了 WebAssembly SDK，具有簡單易用和快速部署的特點，能為開發者提供高效的開發體驗。

🚀 快速開始

要使用 JS MCP 服務器，您需要完成安裝和構建步驟。

📦 安裝指南

請按照以下步驟進行安裝：

git clone https://github.com/justin-echternach/js-mcp-server.git
cd js-mcp-server
npm install -g @bytecodealliance/componentize-js @bytecodealliance/jco
npm install

📦 構建步驟

要構建項目並生成 WebAssembly 模塊，可執行以下命令：

npm run build

這將使用 Vite 打包 JavaScript 代碼，並生成到 dist/js-mcp-server.wasm 文件。

✨ 主要特性

自定義服務器

您可以通過添加或修改處理程序（也稱為工具）來自定義服務器。處理程序位於 server.js 文件中，並存儲在 handlers 目錄下。

處理程序開發規範

每個處理程序應導出 id、name、description 和 method 等內容。

支持 Postgres 和 HTTP 接口

SDK 提供了查詢數據庫的函數和便捷的 HTTP 客戶端方法。

💻 使用示例

自定義服務器示例

例如，要添加一個名為 MyTool 的新工具：

import { myTool } from './handlers/my-tool';

// 在 server.js 中
const server = new MCP.Server({
  tools: {
    ...defaultTools,
    myTool: myTool
  }
});

處理程序開發示例

export const myTool = {
  id: 'my-tool-id',
  name: 'My Tool Name',
  description: 'This is a custom tool that does something.',
  method: async (context, parameters) => {
    // 處理邏輯
    return { result: 'processed' };
  }
};

Postgres 查詢示例

import { query } from '../sdk/database';

export async function handleDatabaseQuery(context, parameters) {
  try {
    const result = await query('SELECT * FROM my_table WHERE id = $1', [parameters.id]);
    return { data: result };
  } catch (error) {
    return { error: error.message };
  }
}

HTTP 客戶端示例

import { get, post } from '../sdk/http';

export async function fetchData(context, parameters) {
  try {
    const response = await get('https://api.example.com/data', {
      headers: {
        'Authorization': `Bearer ${parameters.token}`
      }
    });
    return { data: response.body };
  } catch (error) {
    return { error: error.message };
  }
}

📚 詳細文檔

處理程序開發指南

每個處理程序應導出以下內容：

• id：字符串，工具的唯一標識符。
• name：字符串，工具的名稱。
• description：字符串，工具的描述。
• method：函數，處理邏輯。

使用 Postgres 和 HTTP 接口

Postgres 查詢

SDK 提供了查詢數據庫的函數。

HTTP 客戶端

SDK 提供了便捷的 HTTP 客戶端方法。

最佳實踐

• 錯誤處理：始終使用 try/catch 包裹敏感代碼塊，確保異常被正確捕獲和處理。
• 輸入驗證：對所有外部輸入進行嚴格的驗證和清理，防止潛在的安全漏洞。
• 性能優化：儘量避免在處理程序中執行高開銷操作，考慮異步處理和並行執行。
• 文檔記錄：為每個工具提供詳細的文檔，包括輸入參數、輸出格式和可能的錯誤情況。

通過遵循這些最佳實踐，您可以構建高效、安全且易於維護的 JS MCP 服務器。