MCP Use

🚀 Unified MCP Client Library

🌐 The MCP Client is an open - source solution that enables you to connect any large language model to any MCP server using TypeScript/Node.js. It allows you to build custom agents with tool access without relying on closed - source code.

💡 It empowers developers to easily connect any large language model to tools such as web browsing, file operations, and 3D modeling via LangChain.js.

✨ Features

🚀 Quick Start

📦 Installation

npm install mcp-client

💻 Usage Examples

Basic Usage

const { MCPClient } = require('mcp-client');

// Initialize the MCP client
const client = new MCPClient({
  endpoint: 'http://localhost:5000',
  apikey: 'your-api-key'
});

// Invoke the model for inference
async function main() {
  const response = await client.invoke({
    model: "gpt-3.5-turbo",
    messages: [{ role: "user", content: "Hello, MCP!" }]
  });
  
  console.log(response);
}

main();

Advanced Usage

Configuration File

You can create a file named config.json to configure multiple MCP servers:

{
  "servers": [
    {
      "name": "Local Development",
      "url": "http://localhost:5000",
      "apikey": "local-dev-key"
    },
    {
      "name": "Production Environment",
      "url": "https://api.mcp.com",
      "apikey": "prod-environment-key"
    }
  ],
  "default-server": "Local Development"
}

Multiple Servers Example

const { MCPClient } = require('mcp-client');

async function main() {
  // Initialize all available MCP servers
  const client = new MCPClient({
    config: 'config.json'
  });

  // Select an appropriate server based on the context
  const response = await client.invokeByContext({
    context: "Development Environment",
    model: "gpt-3.5-turbo",
    messages: [{ role: "user", content: "Hello, MCP!" }]
  });
  
  console.log(response);
}

main();

Tool Access Control

Restrict access to specific tools via the configuration file or programmatically:

{
  "access-control": {
    "tools": {
      "network_browser": { "allow": true },
      "file_system": { "allow": false }
    }
  }
}

Contributors

📄 License

MIT © Zane