Valyu

Servidor MCP Valyu

Um servidor Model Context Protocol que fornece acesso às APIs de recuperação de conhecimento e feedback da Valyu. Este servidor permite que LLMs pesquisem fontes proprietárias e da web para obter informações e enviem feedback sobre transações.

Ferramentas Disponíveis

• knowledge - Pesquisar fontes proprietárias e/ou da web para obter informações

  • Argumentos obrigatórios:
    • query (string): A pergunta ou tópico a ser pesquisado
    • search_type (string): Tipo de fontes a pesquisar ("proprietary", "web" ou "all")
    • max_price (number): Preço máximo permitido por mil consultas (CPM)
  • Argumentos opcionais:
    • data_sources (string[]): Lista de nomes de índices para pesquisar
    • max_num_results (integer): Número de resultados retornados após o reordenamento
    • similarity_threshold (number): Pontuação mínima de similaridade para resultados incluídos
    • query_rewrite (boolean): Se deve reescrever a consulta para melhor desempenho

• feedback - Enviar feedback do usuário para uma transação

  • Argumentos obrigatórios:
    • tx_id (string): ID da transação para fornecer feedback
    • feedback (string): Texto do feedback do usuário
    • sentiment (string): Classificação de sentimento ("very good", "good", "bad", "very bad")

Instalação

Usando Docker

docker pull ghcr.io/tiovikram/valyu-mcp-server
docker run -i --rm -e VALYU_API_KEY=your-api-key ghcr.io/tiovikram/valyu-mcp-server

Configuração

Variáveis de Ambiente

• VALYU_API_KEY (obrigatório): Sua chave de API da Valyu

Configurar para Claude.app

Adicione às suas configurações do Claude:

Using Docker

"mcpServers": {
  "valyu": {
    "command": "docker",
    "args": ["run", "--pull", "--rm", "-i", "-e", "VALYU_API_KEY", "ghcr.io/tiovikram/valyu-mcp-server"],
    "env": {
      "VALYU_API_KEY": "<your-valyu-api-key>"
    }
  }
}

Exemplos de Interações

1. Pesquisa de conhecimento:

{
  "name": "knowledge",
  "arguments": {
    "query": "What is quantum computing?",
    "search_type": "all",
    "max_price": 0.5,
    "data_sources": ["valyu/valyu-arxiv", "valyu/valyu-wikipedia"],
    "max_num_results": 5
  }
}

2. Enviar feedback:

{
  "name": "feedback",
  "arguments": {
    "tx_id": "12345abcdef",
    "feedback": "The information was very helpful and accurate.",
    "sentiment": "very good"
  }
}

Depuração

Você pode usar o inspetor MCP para depurar o servidor:

npx @modelcontextprotocol/inspector node dist/index.js

Exemplos de Perguntas para Claude

1. "Você pode pesquisar informações sobre inteligência artificial na medicina?"
2. "Gostaria de aprender sobre soluções de energia sustentável. Você pode pesquisar sobre isso?"
3. "Por favor, ajude-me a enviar feedback para minha transação com ID TX123456."
4. "Encontre-me as pesquisas mais recentes sobre estratégias de adaptação às mudanças climáticas."