Skip to content

Files

Latest commit

aac117f Β· Nov 21, 2024

History

History
Cannot retrieve ahead/behind information for this branch.

MCP servers NPM Version

MIT License

A collection of reference implementations and community-contributed servers for the Model Context Protocol (MCP). This repository showcases the versatility and extensibility of MCP, demonstrating how it can be used to give Large Language Models (LLMs) secure, controlled access to external tools and data sources.

🌟 Featured Servers

  • Filesystem - Secure file operations with configurable access controls
  • GitHub - Repository management, file operations, and GitHub API integration
  • Google Drive - File access and search capabilities for Google Drive
  • PostgreSQL - Read-only database access with schema inspection
  • Slack - Channel management and messaging capabilities
  • Memory - Knowledge graph-based persistent memory system
  • Puppeteer - Browser automation and web scraping
  • Brave Search - Web and local search using Brave's API
  • Google Maps - Location services, directions, and place details

πŸš€ Getting Started

The servers in this repository can be used directly with npx. For example:

npx -y @modelcontextprotocol/server-memory

This will start the Memory server. However, this isn't very useful on its own, and should instead be configured into an MCP client. For example, here's the Claude Desktop configuration to use the above server:

{
  "mcpServers": {
    "memory": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-memory"]
    }
  }
}

Additional examples might look like:

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/allowed/files"]
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "<YOUR_TOKEN>"
      }
    },
    "postgres": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres", "postgresql://localhost/mydb"]
    }
  }
}

πŸ› οΈ Creating Your Own Server

Interested in creating your own MCP server? Visit the official documentation at modelcontextprotocol.io for comprehensive guides, best practices, and technical details on implementing MCP servers.

🀝 Contributing

See CONTRIBUTING.md for information about contributing to the MCP servers repository.

πŸ”’ Security

See SECURITY.md for reporting security vulnerabilities.

πŸ“œ License

This project is licensed under the MIT License - see the LICENSE file for details.

πŸ’¬ Community

⭐ Support

If you find MCP servers useful, please consider:

  • Starring the repository
  • Contributing new servers or improvements
  • Sharing your experience with the community

Managed by Anthropic, but built together with the community. The Model Context Protocol is open source and we encourage everyone to contribute their own servers and improvements!