mcp-servers

# MCP Servers Open Source MCP (Message Control Protocol) Servers for Scientific Research ## Installation Options ### Option 1: Using PyPI Version Install the latest stable version from PyPI using the following configuration: ```json { "mcpServers": { "mcp-txyz-search": { "command": "uvx", "args": ["mcp-txyz-search"], "env": { "TXYZ_API_KEY": "YOUR_TXYZ_API_KEY_HERE" } } } } ``` ### Option 2: Using Latest Main Branch For the most recent development version, use this configuration: ```json { "mcpServers": { "mcp-txyz-search": { "command": "uvx", "args": [ "--from", "git+https://github.com/pathintegral-institute/mcp-servers#subdirectory=servers/txyz-search", "mcp-txyz-search" ], "env": { "TXYZ_API_KEY": "YOUR_TXYZ_API_KEY_HERE" } } } } ``` ### Option 3: Using Specific Branch To use a specific branch, modify the configuration as follows: ```json { "mcpServers": { "mcp-txyz-search": { "command": "uvx", "args": [ "--from", "git+https://github.com/pathintegral-institute/mcp-servers@branch_name#subdirectory=servers/txyz-search", "mcp-txyz-search" ], "env": { "TXYZ_API_KEY": "YOUR_TXYZ_API_KEY_HERE" } } } } ``` ## Creating a New Server ### 1. Initialize Server Package Create a new server package using UV: ```sh uv init servers/your-new-server --package uv --directory servers/your-new-server add mcp ``` ### 2. Configure Server Create or update `servers/your-new-server/src/your_new_server/__init__.py`: ```python def main(): from mcp.server.fastmcp import FastMCP import logging # Configure logging logging.basicConfig( level=logging.INFO, format='%(asctime)s - %(levelname)s - %(name)s - %(message)s' ) logger = logging.getLogger(__name__) # Initialize MCP server mcp = FastMCP() # Define your tools @mcp.tool() async def add(a: int, b: int) -> str: return str(a + b) # Start server logger.info('Starting your-new-server') mcp.run('stdio') ``` ### 3. Launch Server Run your server using: ```sh uv --directory servers/your-new-server run your-new-server ``` Upon successful startup, you should see output similar to: ```text 2025-04-01 10:22:36,402 - INFO - your_new_server - Starting your-new-server ``` ## Contributing We welcome contributions to MCP Servers! Here's how you can help: 1. Fork the repository 2. Create a feature branch (`git checkout -b feature/amazing-feature`) 3. Commit your changes (`git commit -m 'Add amazing feature'`) 4. Push to the branch (`git push origin feature/amazing-feature`) 5. Open a Pull Request Please ensure your PR adheres to: - Clear commit messages - Proper documentation updates - Test coverage for new features ## License This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details. ## Acknowledgments - Thanks to all contributors