MCP cover image
See in Github
2025-04-04

Le serveur VALYU MCP est un outil de protocole de contexte de modèle (MCP) qui permet aux modèles AI de récupérer un contexte de haute qualité de l'API de Valyu, y compris des capacités de recherche complètes sur Wikipedia, Arxiv (idéal pour la finance, la recherche, etc.) et la recherche Web.

1

Github Watches

2

Github Forks

0

Github Stars

Valyu MCP Server

The Valyu MCP Server is a Model Context Protocol (MCP) tool that enables AI models to retrieve high-quality context from Valyu's API, including full search capabilities over Wikipedia, arXiv papers (great for finance, research, etc.), and web search.

Prerequisites

Before setting up the MCP server, ensure you have the following:

  1. Python 3.10+
  2. Claude Desktop (latest version)
  3. Valyu API Key (Get one from Valyu Exchange)

To check your Python version, run:

python --version

Installation & Configuration

Option 1: Automated Setup (Recommended)

  1. Clone the repository
git clone https://github.com/ValyuNetwork/valyu-mcp.git
cd valyu-mcp
  1. Run the setup script
chmod +x setup.sh  
./setup.sh       

The setup script will:

  • Create and activate a virtual environment
  • Install all dependencies
  • Prompt you for your Valyu API key
  • Create the necessary .env file
  • Provide instructions for updating your Claude Desktop configuration

Option 2: Manual Setup

If you prefer to set up manually or the automated setup doesn't work for your environment, follow these steps:

  1. Clone the repository
git clone https://github.com/ValyuNetwork/valyu-mcp.git
cd valyu-mcp
  1. Create a virtual environment and activate it
python -m venv .venv
source .venv/bin/activate  # macOS/Linux
.venv\Scripts\activate    # Windows
  1. Install dependencies
pip install -r requirements.txt
  1. Create a .env file in the project root:
echo "VALYU_API_KEY=your-api-key-here" > .env
  1. Open your Claude Desktop config file for editing:

    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • Windows: %APPDATA%\Claude\claude_desktop_config.json

    If the config file doesn't exist:

    1. Open Claude Desktop
    2. Go to Settings
    3. Enable Developer Mode in the Developer tab
    4. The config file will be generated automatically

    You can open this file in VS Code using:

    code ~/Library/Application\ Support/Claude/claude_desktop_config.json  # macOS
    code %APPDATA%\Claude\claude_desktop_config.json  # Windows (PowerShell)
    
  2. Add the following entry under mcpServers:

{
  "mcpServers": {
    "valyu-mcp": {
      "command": "/ABSOLUTE/PATH/TO/.venv/bin/python",
      "args": ["-u", "/ABSOLUTE/PATH/TO/valyu-mcp.py"],
      "env": {
        "VALYU_API_KEY": "your-api-key-here"
      }
    }
  }
}

Running the MCP Server

  1. Start the server manually (for testing):
python valyu-mcp.py
  1. Start Claude Desktop and verify the MCP tool is recognized:
    • Look for the valyu-mcp tool in the Claude interface.
    • Test a query in Claude (e.g., "What are the latest papers on reinforcement learning?").

Testing and Debugging

Check logs if you encounter issues:

tail -n 20 -F ~/Library/Logs/Claude/mcp*.log  # macOS
Get-Content $env:APPDATA\Claude\Logs\mcp_valyu-mcp.log -Wait  # Windows

Troubleshooting

  • ModuleNotFoundError: Ensure your virtual environment is activated before running the script.
  • Server doesn't start: Check paths in claude_desktop_config.json.
  • No results from Valyu API: Verify your API key is valid and has credits.

Free Credits & API Access

Sign up at Valyu Exchange and claim your $10 free credits to test Valyu API with the MCP server.

Contributing

Pull requests are welcome! Feel free to open an issue for bug reports or feature requests.

License

This project is licensed under the MIT License.


For more information about what we are building at Valyu, visit valyu.network. And check out our blogs at valyu.network/blog.

相关推荐

  • NiKole Maxwell
  • I craft unique cereal names, stories, and ridiculously cute Cereal Baby images.

  • https://jgadvisorycpa.com
  • This GPT assists in finding a top-rated business CPA - local or virtual. We account for their qualifications, experience, testimonials and reviews. Business operators provide a short description of your business, services wanted, and city or state.

  • https://suefel.com
  • Latest advice and best practices for custom GPT development.

  • Yusuf Emre Yeşilyurt
  • I find academic articles and books for research and literature reviews.

  • https://maiplestudio.com
  • Find Exhibitors, Speakers and more

  • Carlos Ferrin
  • Encuentra películas y series en plataformas de streaming.

  • Joshua Armstrong
  • Confidential guide on numerology and astrology, based of GG33 Public information

  • Emmet Halm
  • Converts Figma frames into front-end code for various mobile frameworks.

  • Elijah Ng Shi Yi
  • Advanced software engineer GPT that excels through nailing the basics.

  • lumpenspace
  • Take an adjectivised noun, and create images making it progressively more adjective!

  • apappascs
  • Découvrez la collection la plus complète et la plus à jour de serveurs MCP sur le marché. Ce référentiel sert de centre centralisé, offrant un vaste catalogue de serveurs MCP open-source et propriétaires, avec des fonctionnalités, des liens de documentation et des contributeurs.

  • ShrimpingIt
  • Manipulation basée sur Micropython I2C de l'exposition GPIO de la série MCP, dérivée d'Adafruit_MCP230XX

  • OffchainLabs
  • Aller la mise en œuvre de la preuve de la participation Ethereum

  • modelcontextprotocol
  • Serveurs de protocole de contexte modèle

  • huahuayu
  • Une passerelle API unifiée pour intégrer plusieurs API d'explorateur de blockchain de type étherscan avec la prise en charge du protocole de contexte modèle (MCP) pour les assistants d'IA.

  • Mintplex-Labs
  • L'application tout-en-un desktop et Docker AI avec chiffon intégré, agents AI, constructeur d'agent sans code, compatibilité MCP, etc.

    Reviews

    3 (1)
    Avatar
    user_MrAKxqDf
    2025-04-16

    @microsoft/playwright Mcp is an outstanding tool provided by Microsoft! It offers seamless functionality for automated testing and cross-browser interoperability. The reliability and performance have significantly improved our development workflow. Highly recommend it to any developer looking for a robust testing solution. Check it out at https://mcp.so/server/@microsoft/playwright-mcp/microsoft.